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1 About This Document 





Overview 


This document contains information that is needed to develop a PSP™ Internet radio player. 
The procedure 1s explained through the use of sample programs and data. 


Specifically, this document contains the following information. 


Overview of the structure and operation of an Internet radio player 
Procedure for developing an Internet radio player 


Extended JavaScript method reference 


Overview of Internet radio player icons and how to create them 


Who Should Read This Document? 


This document is intended for anyone who is interested in developing a PSP™ Internet radio 


player. 


For example, a broadcaster who provides an existing Internet radio service can develop a 
special-purpose Internet radio player that receives their local broadcasts. Users who obtain 
that Internet radio player will be able to listen to those broadcasts on the PSP™ Internet 


radio. 


In addition, a normal user who 1s not a broadcaster can create and release an Internet radio 
player that has a unique user interface, is easier to use, or has features not found in the player 


released by SCE. 


The difference between the two types of Internet radio player software developers mentioned 
above is that one type has broadcast station information from which the audio data stream is 
transmitted and the other does not. Although the essential part of the Internet radio player 
implementation will be exactly the same, the two implementations can result in different 


amounts of JavaScript program code that must be written. 


A person who is not a broadcaster (i.e. someone who is not personally broadcasting) must 
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somehow obtain broadcast station information. Both "Internet Radio Player I" and "Internet 
Radio Player II" provided by SCE rely on the SHOUTcast and icecast.org protocols to 
dynamically obtain this information. When a person who is not a broadcaster develops an 
Internet radio player, that person must use this same process to obtain this information 
dynamically. 

Since broadcast station information by nature is constantly changing over time, having the 
Internet radio player save this information either internally or externally is not recommended 


because of the long-term maintenance and software stability problems it can create. 


One method of addressing this problem 1s to have the JavaScript program code that forms the 
Internet radio player dynamically collect the information. Another method would be to 
perform this processing on a regular basis using a service such as cron, or to have it done at 
some specific time using a cgi program running on the Web server where the Internet radio 


player is located. 


The second half of this document describes an example implementation in JavaScript for 
performing this processing, similar to the method used by "Internet Radio Player I" and 
"Internet Radio Player II". 

Å broadcaster should remove the JavaScript code that accesses the broadcast station database 


from this example implementation. 


Specific details concerning the implementation of a cgi program or cron job running on a Web 


server have been omitted from this document. 


This document assumes that readers have a basic knowledge of HTML, XML, JavaScript, Web 


servers, and Internet radio. 


What Specifically gets Created when an Internet Radio Player is Developed? 


Developing an Internet radio player means creating the following two items. 


© The Internet radio player itself 


@ An Internet radio player icon 
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The "Internet radio player" is made up of HTML, JavaScript, and image data. These comprise 
the Internet radio GUI, which acts in conjunction with PSP™ system software to govern the 


behavior of the Internet radio player. 





Example of an Internet Radio Player GUI 
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The Internet radio player icon is used to launch the Internet radio player. It is displayed on 


the XMB'M under the "Network" category, in the layer below "Internet radio". 


The Internet radio player icon is created using a tool that is bundled with the SDK. This 


document is also included in the SDK. 


There is a 1-to-1 correspondence between an Internet radio player and an Internet radio 


player icon. 


12/1 18:19 du] 


internet Radio Player II 





Example of an Internet Radio Player Icon 
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Related Documents 


For details concerning Internet browser specifications and related information, refer to the 


following documents. 


Internet Browser Specifications 
Content Creation Guidelines for the PSP™ (PlayStation&Portable) Internet Browser 
Protocols 


[RFC2616] Hypertext Transfer Protocol - HTTP/1.1 
PERSISTENT CLIENT STATE HTTP COOKIES 


http://wp.netscape.com/newsref/std/cookie spec.html 
Markup Languages 


HTML 4.01 Specification http://www.w3.org/TR/html401/ 
XHTMLTM 1.1- Module-Based XHTML http://www.w3.org/TR/xhtml11/ 
XHTMLTM Basic http://www.w3.org/TR/xhtml-basic/ 


CSS 


Cascading Style Sheets, levell http://www.w3.org/TR/REC-CSS1 
Cascading Style Sheets, level2 http://www.w3.org/TR/REC-CSS2/ 


JavaScript 


Standard ECMA-262 


http://www.ecma-international.org/publications/standards/Ecma-262.htm 
icecast 
http://www .icecast.org/docs.php 


SHOUTcast 


http://www.shoutcast.com/support/docs/ 
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2 PSP™ Internet Radio Structure and Operation 





The PSP™ Internet radio system is conceptually divided into the following three main 

components. 

1. An Internet radio player icon, which is displayed on the XMB™ as explained in the 
previous chapter. 

2. An Internet radio player, which appears as a GUI in the PSP™ Internet browser. 

3. The SHOUTcast/icecast2 protocol handler, which receives SHOUTcast or icecast2 


protocol audio data streams for playback. 


The following figure shows the position of these three components within the entire Internet 


radio player system. 


SHOUTcast/ 
icecast2 
server 


Ordinary web browser 


PSP™ external 


T 
C 
BA 
9 
a 
E 
E 

A. 
o 
A. 
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PSP™ Internal 


(A) PSP™ system (hardware) 
The PSP™ (PlayStation®Portable) system. 


PSP™ system software 
Includes the operating system, device drivers, audio decoders, network access libraries, 


graphics libraries, and other basic software. 


© XMB™ 

Xross media bar. 

The XMB™ displays the Internet radio player icon under the "Network" category, in the 
layer below "Internet radio". The XMB™ also displays information associated with the 


Internet radio player icon and is responsible for launching the Internet radio player. 


©) Internet browser 

PSP™ Internet browser. 

The functionality of the PSP™ Internet browser has been extended so that it works with 
the © SHOUTcast/icecast2 protocol handler. The © Internet radio player can use 
Javascript methods to access this additional functionality for controlling the incoming 


audio data stream and for obtaining additional information. 


© SHOUTcast/icecast2 protocol handler 
The SHOUT cast/icecast2 protocol handler connects to the broadcast server, receives an 


audio data stream that contains content meta information, then passes that stream to an 
audio decoder to decode and output audio. The © SHOUTcast/icecast2 protocol handler 
has functions for parsing Playlist (PLS) data, and for creating a JavaScript String object 
representing the response from an HTTP GET sent to an arbitrary URL. 

In addition, the © Internet radio player can interface with the JavaScript extended 
methods provided by the © Internet browser to obtain content meta information extracted 


by the © SHOUTcast/icecast2 protocol handler in the form of a JavaScript String object. 


The complete system comprising these components (A) to © is referred to as the “PSP™ 


Internet radio player core system.” 
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PSP™ External 


(E Internet radio player icon 

A file containing data that 1s used for displaying the Internet radio player icon on the 
XMB™. 

The file is located in the '"/PSP/RADIOPLAYER" directory on a Memory Stick Duo™. The 
file extension is ".prs". 


The data contains the following information (details described later). 


€ Name of Internet radio player (required) 

€ URL of Internet radio player (required) 

@ Icon image (optional) 

@ Icon focus image (optional) 

@ Comment about the Internet radio player (optional) 
@ URL of author's website (optional) 

@ Author's name (optional) 


@ Copyright information (optional) 


The above information can be displayed from the © XMBTM. 
The Internet radio player's author is responsible for creating the Internet radio player icon. 
The Internet Radio Player SDK comes with a tool that can be used to create the icon. This 


document is also included in the SDK. 


@ Internet radio player 

GUI of the PSP™ Internet radio player. 

The GUI consists of HTML, JavaScript, and image files. 

The © Internet browser can control functions provided by the © SHOUTcast/icecast2 
protocol handler by invoking JavaScript methods defined in the Internet radio player. 
These functions can be used to control the connection to a broadcast server. Information 
obtained from the © SHOUTcast/icecast2 protocol handler is displayed on-screen via the 
(D Internet browser. 

The © Internet radio player is placed on a Web server provided by the Internet radio 
player's author. The @ Internet radio player is a client-side application that runs on the 
(D Internet browser. It is not a server-side application. Therefore, server-side scripts are 


not necessary. 
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HINT 


As described in Chapter 1, part of the processing of an Internet radio player can also be 


implemented by a server-side cgi program or service such as cron. 


(H) Broadcast server 

Distributes the SHOUTcast or icecast2 protocol audio data stream. 

To receive an audio stream, the © Internet radio player connects to the @ broadcast 
server either by directly specifying its URL, or from information contained in playlist or 
M3U data that points to the desired server. 

Broadcast server URL information or playlist (PLS or M3U) information can be obtained 
from the Stream Directory page administered by icecast.org or the SHOUTcast 
SHOWCASE page administered by AOL. 
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The PSP™ Internet radio can also be implemented in JavaScript that describes the 
information collection processing related to the © broadcast server, using the © Internet 
browser and © SHOUTcast/icecast2 protocol handler functions. 


The following figure shows this type of implementation. 


"Internet Radio Player I," which is an Internet radio player that SCE made publicly 
available, uses SHOUTcast SHOWCASE information. Similarly, "Internet Radio Player II" 
uses the Stream Directory of icecast.org. 

The second half of this document describes a sample Internet radio player that uses the 


Stream Directory of icecast.org. 


© 
c 
= 
0 
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o 
5 

= 
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0 
D. 


PSP™ internal 





(W Broadcast station information database) 

Database system containing broadcast station information used for distributing audio data 
streams via the SHOUTcast or icecast2 protocols. 

Specifically, this database system corresponds to the SHOUTcast SHOWCASE administered 
by AOL and the Stream Directory administered by icecast.org. 

Each database system has its own proprietary set of Web APIs. For details related to these, 


refer to the documentation for the database system in use. 
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The © Internet radio player uses these Web APIs to find specific broadcast stations such as 
those offering a particular music genre. This information can be used to create a broadcast 
station list. 

This processing is performed by the part in the figure marked as "database accessor". However, 
the database accessor is not a real entity, but rather an abstract entity defined in JavaScript. 
It is a set of components that provide functions such as HTTP GET processing, string parsing, 


and processing for generating an information array. 


When the URL of the broadcast server is fixed such as when a broadcaster develops software 
for a local station-specific Internet radio player, the database accessor and the (D broadcast 


station information database are unnecessary. 
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The explanation below divides the interrelationships among resources related to PSP™ 
Internet radio into three main scenarios. 


The PSP™ Internet radio can support all three of these scenarios. 


Scenario 1: The broadcast content provider and the broadcast server provider create a 


dedicated Internet radio player for receiving their own broadcasts 


The scenario shown in this figure applies when a broadcaster creates a local station-specific 
Internet radio player. 

Since the broadcaster (= player author) knows the information required for the connection 
such as the URL and port number of the broadcast server, the broadcast station information 
database is unnecessary. 

This information (which are default values) can be hardcoded into the Internet radio player. 
The Internet radio player can also be implemented so that default information related to the 
broadcast server 1s dynamically read by the Internet radio player from a separate file apart 
from the html or JavaScript. In this case, the format of this file is arbitrary. 

The Internet radio player can be implemented in this way without requiring any non-local 


station resources. 











138-- 
Audio stream and 
content meta information 


Internet radio 
player 


Internet radio player provider, 
Broadcast server provider, 
Broadcast content provider 
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Scenario 2: The broadcast station information database provider and the broadcast server 


provider are the same 


The scenario shown in this figure applies when the broadcast content provider is separate 
from the broadcast server provider and the broadcast station information database provider. 
Scenario 2 can has the same form as Scenario 3 where the broadcast station information 
database provider, the broadcast server provider, the broadcast content provider, and the 
Internet radio player provider are separate entities. 

The "Broadcast client" in this figure refers to music player software such as Winamp and 


plugin software for connecting to the broadcast server. 









Internet radio 
player 





IA 


Audio stream and 
^w | content meta information 


Station information 
being broadcast 
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Audio stream and 
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Scenario 3: The broadcast station information database provider, the broadcast server 
provider, the broadcast content provider, and the Internet radio player provider are separate 


entities 


"Internet Radio Player I" and "Internet Radio Player II," which are provided by SCE, are 


implementations based on this format. 





Internet radio 
player 














MIA 
Audio stream and 
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Station information 
being broadcast 





Audio stream and 
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3 Creating the Internet Radio Player 





This chapter explains how to create the PSP™ Internet radio player, which was briefly 
mentioned in Chapter 1. 

As explained in the previous chapters, the PSP™ Internet radio player consists of HTML and 
Javascript. Some css and image files are also added as components to create the external 
appearance of the Internet radio player and to increase maintainability. Since the Internet 
radio player is created by the same process as creating an ordinary Web page, the effort 


required is also the same. 


However, an ordinary Web page alone cannot function as an Internet radio player. 
Mechanisms for producing sound and for finding broadcast stations are required for it to 
function as an Internet radio player. 

To implement these capabilities on an ordinary Web page, 59 JavaScript extended methods 
are provided as part of the PSP™ Internet radio system. These extended methods will give the 


Web page the additional capabilities needed to function as an Internet radio player. 


When the Internet browser is launched as a PSP™ Internet radio player from the Internet 
radio icon under the "Network" category of the XMB™, this group of 52 extended methods is 
added to the PSP™ Internet browser. When the browser is started up as a normal PSP™ 


Internet browser, this group of methods cannot be used. 


Some of the principal extended methods include sysRadioPlayPls, which accesses a playlist file 
to play audio, sysRadioPlayStream for directly connecting to a broadcast server, and 
sysRadioPrepareForHttpGet, which accesses an arbitrary URL to perform an HTTP GET 
operation. 

By combining these extended methods, you can perform a series of functions such as: obtaining 
broadcast station information from the Stream Directory page of icecast.org, parsing the 
HTML or XML string that is obtained, constructing the URL for accessing the broadcast 
station's playlist file, using the playlist's URL to connect to the broadcast server (audio data 
stream server), and finally receiving the audio data stream. 

The PSP™ Internet radio player is the entity that performs this processing, interacts with the 
user, and displays information on-screen such as the broadcast station's name and the content 


being played. 
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HINT 

It is technically possible to receive a live audio data stream by invoking the action script 
"Sound.loadSound()" on the Flash player within the PSP™ Internet browser, however, 
proper operation is not currently guaranteed. This is because the Flash player that 1s 
currently implemented in system software will continuously accumulate a received audio 
data stream in the PSP™ system's internal memory. Therefore, playing (receiving) audio 
using the Flash player's "Sound.loadSound()" will eventually cause an "Insufficient 


memory" alert dialog to appear. 
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List of JavaScript Extended Methods 


A list of extended JavaScript methods for the PSP™ Internet radio player is given below. 


Methods for starting and stopping playback 
Method Name Function 


sysRadioPlayStream Start playback by specifying URL of audio data 
stream 


sysRadioPlayPls Start playback by specifying URL of PLS file 
sysRadioPlayM3u Start playback by specifying URL of M3U file 
Stop playback 





Methods for controlling output volume 
Method Name Function 
sysRadioSetMasterVolume Set master volume level 


sysRadioSetSubVolume Set sub volume level 


Methods for getting audio output level 
Method Name Function 
sysRadioGetLeftAudioPeakLevel Get peak audio level being output from audio left 
channel. 
Used for displaying audio level meter, etc. 
sysRadioGetRightAudioPeakLevel Get peak audio level being output from audio 
right channel. 


Used for displaying audio level meter, etc. 
sysRadioGetLeftAudioAverageLevel Get average audio level being output from audio 

left channel. 

Used for displaying audio level meter, etc. 
sysRadioGetRightAudioAverageLevel | Get average audio level being output from audio 

right channel. 

Used for displaying audio level meter, etc. 





Methods for controlling sound effects 
Method Name Function 
sysRadioSetSineWaveOscillatorFrequencyAndVolume | Set oscillation frequency and 
volume level of sine wave 
oscillator 
sysRadioSetWhiteNoiseOscillatorVolume Set volume level of pseudo white 


noise oscillator 


sysRadioSetAudioShift Width Set shift width of audio frequency component 
sysRadioSetAudioCutOffWidth Set cut-off width of audio frequency component 


sysRadioSetAudioPitchShiftWidth Set pitch shift width of audio frequency 
component 


sysRadioPlay EffectSound Play sound effect 
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Methods related to "HTTP GET" processing 
Method Name Function 


sysRadioPrepareForHttpGet Prepare to perform HTTP GET for specified URL 


sysRadioGetHttpGetStatus Report status of sysRadioPrepareForHttpGet 
processing 


result as string 
housekeeping 


Method for getting internal status 








Method Name Function 


| sysRadioGetPlayerStatus | Get internal status of player system | 


Methods for getting playback quality numeric values and playback information strings 
Method Name Function 


evaluation value 
te saturation frequency of sound) 


sysRadioGetContentMetalnfo Get content meta information related to audio 
data stream being played 


sysRadioGetBitRate Get bit rate of audio data stream being played 


sysRadioGetSamplingRate Get sampling rate value of audio data stream 
being played 


Methods for getting information related to audio data stream being played 
Method Name Function 


sysRadioGetStream Url Get URL of audio data stream being played 


played 
stream being played 





stream being played 
audio data stream being played 
stream buffer being played 
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Methods for finding files on the Memory Stick Duo™ 
Method Name Function 


sysRadioPrepareForScanDir Prepare for directory entry scan on the 
Memory Stick Duo!" 


sysRadioScanDir Scan directory and return file entry (filename) 
that was found first. 
For the second and subsequent calls, return the 
file entry (filename) that was found next. 
sysRadioGetMedialnOutStatus Detect whether a Memory Stick Duo™ was 
inserted or removed following previous 
sysRadioPrepareForScanDir 





String search processing methods 
Method Name Function 


sysRadioPrepareForStrOperation Prepare for string search or string extraction 
processing 


sysRadioStrLength Nearly equivalent to JavaScript standard method 
"length." 

Returns string length as value in terms of bytes. 
sysRadioStrIndexOf Nearly eguivalent to JavaScript standard method 
"indexOf." 

Searches for string pattern. 

sysRadioStrSlice Nearly equivalent to JavaScript standard method 
"slice." 
Extracts substring. 

sysRadioStrCharCodeAt Nearly equivalent to JavaScript standard method 
"charCodeAt." 
Returns character code of specific position in 
string. 


sysRadioStrOperationTerminate Terminate string search processing. 


String conversion processing methods 
Method Name Function 


sysRadioCharacterEntityConvert Convert characters that contain a character entity 
name to an actual character 





sysRadioCharacterCodeConvert Convert UTF-8 string to SJIS or EUC-KR string. 


Methods for getting analog pad values 
Method Name Function 


sysRadioGetAnalogStickXValue Get analog stick's X value 
sysRadioGetAnalogStickY Value Get analog stick's Y value 


sysRadioGetAnalogStickAngleValue Get analog stick's angle value 
sysRadioGetAnalogStickRadiusValue | Get analog stick's radius value 
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Methods related to debug log console 
Method Name Function 


sysRadioSetDebugMode Set debug mode 
sysRadioDebugLog Display string on debug log console 


sysRadioSetDebugLogTextStyle Set debug log console's text style (typeface, 
character color, background color, existence of 
shadow, character align attribute) 


sysRadioClearDebugLog Clear strings displayed on debug log console 





Miscellaneous 
Method Name Function 
sysRadioGetPlayerCoreVersionInfo Get Internet radio player system core version 


information 


sysRadioCapabilityCheck Get support information related to a specific 
function 
sysRadioGetStartButtonToggleStatus | Get PSP™ system's START button toggle status 


sysRadioBackLightAlwaysOn Control backlight's always on state when powered 
by external power supply 


sysRadioBusyIndicator Control busy indicator display at bottom left of 
screen 


sysRadioCaptureScreenShot Capture screenshot 


sysRadioSleep Set PSP™ system sleep mode 
sysRadioGetSystemStatus Inquire about internal status of PSP™ system. 
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JavaScript Extended Method Reference Details 


Descriptions of the individual extended JavaScript methods for the PSP™ Internet radio 
player are presented below. 


The description of each method contains a simple sample program that runs independently. 


Programs that are almost identical to these sample programs are also provided on SCE's Web 
server. 

You can access this page and run these programs by using the special Internet radio player 
icon sysRadio method sample.prs, which is included in the SDK that contains this document. 


This icon was created to allow you to run the sample code. 
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sysRadioPlayStream 


Start playback by specifying URL of audio data stream 


Syntax 
result = psp. sysRadioPlayStream (url, userAgentName) 
Arguments 
url URL of playlist 
userAgentName | User agent name used when performing HTTP GET for getting playlist 
information 


Return Value 


0 Normal 
1 Error 


Description 


This extended method connects to the broadcast server specified by url to play audio. 
The user agent name specification argument is used for controlling the behavior of the 


broadcast server. 


If there is no free space in the JavaScript extended method processing queue, -1 is returned. 
At this time, the processing request is ignored (discarded). As long as method calls of types 
that are queued are not continuously issued (such as in an endless loop), this state does not 


normally occur. 


The following methods are types that are queued. 


Method Names of Types That Overview 
are Queued 


sysRadioPlayStream Starts playback by specifying URL of audio data stream 
sysRadioPlayPls Starts playback by specifying URL of PLS file 


sysRadioPlayM3u Starts playback by specifying URL of M3U file 
sysRadioPrepareForHttpGet Prepares for performing HTTP GET for specified URL 
sysRadioCaptureScreenShot 
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HINT 

If the broadcast server is accessed by the Internet browser using an ordinary user 
agent name such as "Mozilla/4.0 (PSP (PlayStation Portable); 2.00)," the audio data 
stream may not be able to be received. When the broadcast server is accessed from the 


Internet browser in this manner, it may just output a Web page for management. 


Example 
var result — psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo_stream/teststream_a.stream.mp3", 
"pspRadioPlayer"); 
This statement accesses the broadcast server 
"http://radio.psp.dl.playstation.net:80/psp/radio/sample/pseudo_stream/teststream_a.strea 
m.mp3" to play audio. 
Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioPlayStream</title> 
</head> 
<body> 
<h1>sysRadioPlayStream</h1> 
<script language="JavaScript"> 
6] == 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc () { 
psp.sysRadioSetMasterVolume (255); 
) 
function test () { 
psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
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} 

Zem 

SET EE EES 

«button onclicks-'test();'--TEST«/button» 

<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 


to run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 
sysRadioPlayPls, sysRadioPlayM3u, sysRadioStop, 
sysRadioSetMasterVolume, sysRadioSetSubVolume, 
sysRadioPrepareForHttpGet, sysRadioCaptureScreenShot 
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sysRadioPlayPis 


Start playback by specifying URL of playlist 


Syntax 
result = psp. sysRadioPlayPls (url, userAgentName0, userAgentName1) 
Arguments 
url URL of playlist 
userAgentName0 User agent name used when performing HTTP GET for getting playlist 
information 


userAgentNamel User agent name used when connecting to broadcast server 


Return Value 


0 Normal 
1 Error 


Description 


This extended method connects to the HTTP server specified by url to get playlist 
information and connects to the broadcast server described in this playlist information to 
play audio. 

The two user agent name specification arguments are used to control the behavior of the 


HTTP server and broadcast server. 


A playlist that is handled by a PSP™ internet radio has the following format. 


[playlist] 

numberofentries=2 
Filel=http://radio.psp.dl.playstation.net/psp/radio/sample/pseudo_stream/teststream_a.stream.mp3 
Titlel=(#1 - 1/100) PSP Internet Radio Test Audio Stream [RADIO PSP] 

Length1--1 

Browserl- 


File2-http://radio.psp.dl.playstation.net/psp/radio/sample/pseudo stream/teststream b.stream.mp3 
Title2=(#2 - 1/100) PSP Internet Radio Test Audio Stream [RADIO PSP] 

Length2--1 

Browser2- 

Version-2 





If there is no free space in the JavaScript extended method processing queue, -1 is returned. 
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At this time, the processing request is ignored (discarded). As long as method calls of types 
that are queued are not continuously issued (such as in an endless loop), this state does not 


normally occur. 


The following methods are types that are queued. 


Method Names of Types That Overview 
are Queued 


sysRadioPlayStream Starts playback by specifying URL of audio data stream 
sysRadioPlayPls Starts playback by specifying URL of PLS file 


sysRadioPlayM3u Starts playback by specifying URL of M3U file 
sysRadioPrepareForHttpGet Prepares for performing HTTP GET for specified URL 


sysRadioCaptureScreenShot Captures screenshot 





HINT 

If the broadcast server is accessed by the Internet browser using an ordinary user 
agent name such as "Mozilla/4.0 (PSP (PlayStation Portable); 2.00)," the audio data 
stream may not be able to be received. When the broadcast server is accessed from the 


Internet browser in this manner, it may just output a Web page for management. 


Example 


var result = psp.sysRadioPlayPls ("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer") 


This statement accesses the playlist 
"http://radio.psp.dl.playstation.net/psp/radio/sample/pseudo_stream/teststream0.pls" and 


connects to the broadcast server according to information in the playlist. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioPlayPls</title> 
</head> 
<body> 
<h1>sysRadioPlayPls</h1> 
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<script language="JavaScript"> 
«eb 
window.onload - function () ( setTimeout ('initProc ()', 500); ) 
function initProc () + 
psp.sysRadioSetMasterVolume (255); 
) 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"): 
psp.sysRadioSetSubVolume (255); 
) 
d 
</SCript> 
«button onclick='test();'>TEST</button> 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 
to run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 
sysRadioPlayStream, sysRadioPlayM3u, sysRadioStop, 
sysRadioSetMasterVolume, sysRadioSetSubVolume, 
sysRadioPrepareForHttpGet, sysRadioCaptureScreenShot 
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sysRadioPlayM3u 


Start playback by specifying URL of M3U file 


syntax 
result = psp. sysRadioPlayM3u (url, userAgentName0, userAgentName1) 
Arguments 
url URL of playlist 
userAgentName0 User agent name used when performing HTTP GET for getting M3U 
file 


userAgentNamel User agent name used when connecting to broadcast server 


Return Value 


0 Normal 
1 Error 


Description 


This extended method connects to the HTTP server specified by url to get M3U data and 
connects to the broadcast server described in this M3U data to play audio. 
The two user agent name specification arguments are used to control the behavior of the 


HTTP server and broadcast server. 


M3U data that is handled by a PSP™ internet radio has the following format. (The 


contents described in this example are fictional or provisional.) 


# PSP Internet Radio Test Audio Stream [RADIO PSP] 
# STREAM 0 (MAIN STREAM) 


http://radio.psp.dl.playstation.net/psp/radio/sample/pseudo stream/teststream a.stream.mp3 
# STREAM 1 (SUB STREAM) 
http://radio.psp.dl.playstation.net/psp/radio/sample/pseudo stream/teststream b.stream.mp3 





If there is no free space in the JavaScript extended method processing queue, -1 is returned. 
At this time, the processing request is ignored (discarded). As long as method calls of types 


that are queued are not continuously issued (such as in an endless loop), this state does not 
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normally occur. 


The following methods are types that are queued. 


Method Names of Types That Overview 
are Queued 


sysRadioPlayStream Starts playback by specifying URL of audio data stream 
sysRadioPlayPls Starts playback by specifying URL of PLS file 


sysRadioPlayM3u Starts playback by specifying URL of M3U file 
sysRadioPrepareForHttpGet Prepares for performing HTTP GET for specified URL 


sysRadioCaptureScreenShot Captures screenshot 





HINT 

If the broadcast server is accessed by the Internet browser using an ordinary user 
agent name such as "Mozilla/4.0 (PSP (PlayStation Portable); 2.00)," the audio data 
stream may not be able to be received. When the broadcast server is accessed from the 


Internet browser in this manner, it may just output a Web page for management. 


Example 


var result = psp.sysRadioPlayM3u ("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo stream/teststream0.m3u", 
"pspRadioPlayer", 
"pspRadioPlayer"); 


This statement accesses M3U data 
"http://radio.psp.dl.playstation.net/psp/radio/sample/pseudo_stream/teststream0.m3u " and 


connects to the broadcast server according to information in the M3U data. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioPlayM3u</title> 
</head> 
<body> 
<h1>sysRadioPlayM3u</h1> 
<script language="JavaScript"> 
ele 
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window.onload = function () ( setTimeout ('initProc ()', 500); j 
function initProc () { 
psp.sysRadioSetMasterVolume (255); 
} 
function test () { 
psp.sysRadioPlayM3u 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.m3u", 
"pspRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
) 
fy ==> 
«/sScript> 
«button onclicks'test(); '»TEST«/button» 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 
to run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 
sysRadioPlayStream, sysRadioPlayPls, sysRadioStop, 
sysRadioSetMasterVolume, sysRadioSetSubVolume, 
sysRadioPrepareForHttpGet, sysRadioCaptureScreenShot 
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sysRadioStop 


otop receiving and playing audio data stream 


Syntax 


psp. sysRadioStop ([mode]) 


Arguments 


mode Identifier of audio data stream to be stopped (optional) 
0: Main audio data stream 
1: Sub audio data stream 


Return Value 


Always 0. 


Description 


If no argument is specified or 0 is assigned for the argument, this extended method stops 
playback of the main audio data stream. 
If 1 is assigned for the argument, this extended method stops playback of the sub audio 


data stream. 


The PSP'M Internet radio system has an internal structure that enables two data streams 
to be handled simultaneously. This enables it to provide seamless play when the broadcast 


station 1s switched. 


When switching reception (switching the connection) from a certain broadcast server B to 
another broadcast server A, the PSP™ Internet radio system starts the connection to 
broadcast server A while maintaining the connection to broadcast server B and continuing 
to play its audio. 

It subsequently starts reception of the audio stream from broadcast server A and when 
sufficient buffering has been completed and preparations for audio playback are finished, it 
disconnects from broadcast server B while switching the audio using the fader. 


Although this processing is automatically performed internally by the PSP™ Internet radio 
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system, it can also be forcibly performed by a sysRadioStop method call. 


In this example, broadcast server A (server that is being faded in) is the main audio data 
stream, and broadcast server B (server that is being faded out) is the sub audio data 


stream. 





O 






Audio 
decoder 


Audio 
decoder 


Sub volume 


Master volume 


The area in the figure above that indicates the processing for switching the two audio data 
streams by using the fader has been simplified. It is represented in this document as shown 


in the following figure. 
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Audio 
decoder 


Sub volume 


Master volume 





Example 


psp.sysRadioStop 0: 


This statement stops playback. 


Sample 


<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioStop</title> 
</head> 
<body> 
<h1>sysRadioStop</h1> 
<script language="JavaScript"> 
<!-- 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function anitProc CH I 
psp.sysRadioSetMasterVolume (255); 
} 
function start () { 
psp.sysRadioPlayStream 


("http://radio.psp.dl.playstation.net:80" 
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+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"pspRadioPlayer"): 
psp.sysRadioSetSubVolume (255); 
} 
function stop () { 


psp.sysRadioStop (); 


} 


לס // 

>< 

<button onclick='start();'>START</button> 
«button onclick='stop(); '>STOP</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 


to run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u, 
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sysRadioSetMasterVolume 


Set master volume level 


Syntax 


psp. sysRadioSetMasterVolume (vol) 


Arguments 


vol Volume value (0€ vol € 255) 


Return Value 


Always 0. 


Description 


This extended method controls the playback volume. 

0 is the lowest volume (silence) and 255 is the highest volume. The default is 0. 

The volume of sound that is output from the audio stream received from the broadcast 
server is determined by the product of the value set by sysRadioSetMaster Volume and the 
value set by sysRadioSetSubVolume. 

The following figure shows the relationship between the sound sources for the PSP™ 


Internet radio and the volume controls. 
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Audio 
decoder 


Sine wave 
oscillator 


sysRadioSetSubVolume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


sysRadioSetWhiteNoiseOscillatorVolume 


White 
noise 
oscillator 


sysRadioSetMasterVolume 


sysRadioPlayEffectSound 


Audio output 


Example 
psp.sysRadioSetMasterVolume (255); 
This statement sets the master volume value to 255 (maximum value). 
Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioSetMasterVolume</title> 
</head> 
<body> 
<h1>sysRadioSetMasterVolume</h1> 
«script languages"JavaScript"- 
«1-- 
window.onload - function () ( setTimeout ('initProc ()', 500); 1 
function initProc () | 
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psp.sysRadioSetMasterVolume (255); 


} 
function test () { 
psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"pspRadioPlayer"): 
psp.sysRadioSetSubVolume (255); 
} 
ו‎ ==> 
</sCript> 
<button onclick='test() ;'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</böody></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 


to run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 


from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u, sysRadioStop, 
sysRadioSetSubVolume 
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sysRadioSetSubVolume 


Set sub volume level 


Syntax 


psp. sysRadioSetSubVolume (vol) 


Arguments 


vol Volume value (0€ vol € 255) 


Return Value 


Always 0. 


Description 


This extended method controls the playback volume. 

0 is the lowest volume (silence) and 255 is the highest volume. The default is 0. 

The volume of sound that is output from the audio stream received from the broadcast 
server is determined by the product of the value set by sysRadioSetMaster Volume and the 
value set by sysRadioSetSubVolume. 
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Audio 
decoder 


sysRadioSetSubVolume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


sysRadioSetWhiteNoiseOscillatorVolume 


PA | ew 
LOW HIGH 
sysRadioSetMaster Volume 


sysRadioPlayEffectSound 


Audio output 


Example 


psp.sysRadioSetSubVolume (255); 


This statement sets the sub value to 255 (maximum value). 


Sample 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioSetSubVolume</title> 

</head> 

<body> 

<h1>sysRadioSetSubVolume</h1> 

<script language="JavaScript"> 

== 

window.onload = function () { setTimeout ('initProc ()', 500); } 


Function initProc () + 
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psp.sysRadioSetMasterVolume (255); 
} 
function test () { 
psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
} 
ו‎ ==> 
</sCript> 
<button onclick='test() ;'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</böody></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 


to run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 


from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u, sysRadioStop, 


sysRadioSetMasterVolume 
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sysRadioGetLeftAudioPeakLevel 


Get peak audio level being output from audio left channel 


Syntax 


System software prior to version 5.00 


result = psp. sysRadioGetLeftAudioPeakLevel () 


System software version 5.00 or later 


result = psp. sysRadioGetLeftAudioPeakLevel ( [mode] ) 


Identifier for specifying the range of the return value 
(see below) 


Integer value in the range 0 = result = 255 
Integer value in the range 0. S result = 32767 
Integer value in the range 0 S result Ss 90 


Arguments 


mode 


Return Value 


When mode is not specified or 
when 0 is specified for mode 
When 1 is specified for mode 
When 2 is specified for mode 


Description 


This extended method gets the peak audio output level of the left channel. 


If mode is not specified or if it is specified as 0, the peak absolute value at point (& in the 


figure below is returned as a value in the range 0 to 255. 


If 1 is specified for mode, the peak absolute value at the same point in the figure is returned 


as a value in the range 0 to 32767. 


If 2 is specified for mode, the peak absolute value at the same point in the figure is 


logarithmically transformed and returned as a value in the range 0 to 90. Specifically, 


processing equivalent to evaluating the following expression is performed internally by the 
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PSP™. 


OSCEI 


result = Math.floor 
(20 * Math.log (psp.sysRadioGetLeftAudioPeakLevel (1) + 1) / Math.log (10)); 






Audio 
decoder 


sysRadioSetSubVolume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


sysRadioSetWhiteNoiseOscillatorVolume 


sysRadioSetMasterVolume 


sysRadioPlayEffectSound 


Audio output 


Example 
var leftAudioLevel = psp.sysRadioGetLeftAudioPeakLevel 0; 
This statement gets the peak audio output level of the left channel at point W in the above 
figure and sets it for leftAudioLevel. 
Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetLeftAudioPeakLevel</title> 
</head> 
<body> 
<hl>sysRadioGetLeftAudioPeakLevel</h1> 
«script languages"JavaSoript"» 
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<!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); j 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255 255, 30,530,40,96, X 2.3 


psp.sysRadioSetMasterVolume (255); 


) 
var tid = 0: 
function intervalProc () { 


var leftAudioLevel = psp.sysRadioGetLeftAudioPeakLevel (); 


psp.sysRadioDebugLog ("left=" + leftAudioLevel + "\n"); 


} 


function test () { 
psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"ospRadioPlayer"); 


psp.sysRadioSetSubVolume (255); 


LE I Cid == ) tid = setInterval ('intervalProc ()', 500); 
} 
ia 
</script> 
<putten onclick="test() 7 '>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 


to run this sample code. 


Since it is not a genuine SHOUTcast or 1cecast2 broadcast server, its behavior will differ 


from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioSetSubVolume, sysRadioGetRightAudioPeakLevel, 
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sysRadioGetLeftAudioAverageLevel, sysRadioGetRightAudioAverageLevel 
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sysRadioGetRightAudioPeakLevel 


Get peak audio level being output from audio right channel 


Syntax 


System software prior to version 5.00 


result = psp. sysRadioGetRightAudioPeakLevel () 


System software version 5.00 or later 


result = psp. sysRadioGetRightAudioPeakLevel ( [mode] ) 


Identifier for specifying the range of the return value 
(see below) 


Integer value in the range 0 = result = 255 
Integer value in the range 0 < result S 32767 
Integer value in the range 0 = result = 90 


Arguments 


mode 


Return Value 


When mode is not specified or 
when 0 is specified for mode 
When 1 is specified for mode 
When 2 is specified for mode 


Description 


This extended method gets the peak audio output level of the right channel. 


If mode is not specified or if it is specified as 0, the peak absolute value at point W) in the 


figure below is returned as a value in the range 0 to 255. 


If 1 is specified for mode, the peak absolute value at the same point in the figure is returned 


as a value in the range 0 to 32767. 


If 2 is specified for mode, the peak absolute value at the same point in the figure is 


PSP™ Internet Radio Player Development Guide 


- 80 - 


OSCEI 


logarithmically transformed and returned as a value in the range 0 to 90. Specifically, 


processing equivalent to evaluating the following expression is performed internally by the 


PSP™, 
result = Math.floor 


(20 * Math.log (psp.sysRadioGetRightAudioPeakLevel (1) + 1) / Math.log (10)); 






Audio 
decoder 


sysRadioSetSubVolume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


sysRadioSetWhiteNoiseOscillatorVolume 


sysRadioSetMasterVolume 


sysRadioPlayEffectSound 


Audio output 


Example 


var rightAudioLevel = psp.sysRadioGetRightAudioPeakLevel 0: 


This statement gets the peak audio output level of the right channel at point @ in the 


above figure and sets it for rightAudioLevel. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetRightAudioPeakLevel</title> 
</head> 
<body> 
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<h1>sysRadioGetRightAudioPeakLevel</h1> 
<script language="JavaScript"> 
ml ee 
window.onload - function () ( setTimeout ('initProc ()', 500); j 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224.221,124,.255, 255,255,255,215, 20730,40,06,. 10 2) 
psp.sysRadioSetMasterVolume (255); 
) 
var tid = 0: 
function intervalProc () ( 
var rightAudioLevel - psp.sysRadioGetRightAudioPeakLevel (): 
psp.sysRadioDebugLog ("right=" + rightAudioLevel + ("מ\"‎ ; 
} 
function test () { 
psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo_stream/teststream_a.stream.mp3", 
"pspRadioPlayer"); 


psp.sysRadioSetSubVolume (255); 


17 | 616 == ) tid = setlInterval ('intervalProc ()', 500); 
} 
(i 5 
</script> 
«button onclick-'test(); '»TEST«/button- 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 
to run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 
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See Also 


sysRadioSetSubVolume, sysRadioGetLeftAudioPeakLevel, 
sysRadioGetLeftAudioAverageLevel, sysRadioGetRightAudioAverageLevel 
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sysRadioGetLeftAudioAverageLevel 


Get average audio level being output from audio left channel 


Syntax 


result = psp. sysRadioGetLeftAudioAverageLevel ( [mode] ) 


Identifier for specifying the range of the return value 
(see below) 


Integer value in the range 0. S result = 255 


Integer value in the range 0 
Integer value in the range 0 


result 
result 


32767 
90 


HA Wé 


Arguments 


mode 


Return Value 


When mode is not specified or 
when 0 is specified for mode 
When 1 is specified for mode 
When 2 is specified for mode 


Description 


This extended method gets the average audio output level of the left channel. 


If mode is not specified or if it is specified as 0, the average absolute value at point (A) in 


the figure below is returned as a value in the range 0 to 255. 


If 1 is specified for mode, the average absolute value at the same point in the figure is 


returned as a value in the range 0 to 32767. 


If 2 is specified for mode, the average absolute value at the same point in the figure is 


logarithmically transformed and returned as a value in the range 0 to 90. Specifically, 


processing equivalent to evaluating the following expression is performed internally by the 


PSP™, 
result = Math.floor 


(20 * Math.log (psp.sysRadioGetLeftAudioAverageLevel (1) + 1) / Math.log (10)); 


PSP™ Internet Radio Player Development Guide 


- 54 - 


OSCEI 


This method can be used with system software version 5.00 or later. 






Audio 
decoder 


sysRadioSetSubVolume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


sysRadioSetWhiteNoiseOscillatorVolume 


sysRadioSetMasterVolume | 
4 PN 
LOW HIGH 


sysRadioPlayEffectSound 


Audio output 


Example 
var leftAudioLevel = psp.sysRadioGetLeftAudioAverageLevel Q; 
This statement gets the average audio output level of the left channel at point W in the 
above figure and sets it for leftAudioLevel. 
Sample 
<html><head> 
«meta http-equiv-"content-type" content-"text/html; charset-utf-8"» 
<title>sysRadioGetLeftAudioAverageLevel</title> 
</head> 
<body> 
<hl>sysRadioGetLeftAudioPeakLevel</h1> 
«script languages"JavaSoripb"'.- 
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«e 
window.onload - function () ( setTimeout ('initProc ()', 500); } 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255 255, 30,530,40,96, X 2.3 


psp.sysRadioSetMasterVolume (255); 


) 
var tid = 0: 
function intervalProc () { 


var leftAudioLevel = psp.sysRadioGetLeftAudioAverageLevel (); 


psp.sysRadioDebugLog (“left=”" + leftAudioLevel + “\n"”); 


} 


function test () { 
psp.sysRadioPlayStream 
(“http://radio.psp.dl.playstation.net: 80” 
+”/psp/radio/sample/pseudo stream/teststream a.stream.mp3”, 
"pspRadioPlayer”); 


psp.sysRadioSetSubVolume (255); 


if { Cid == ) tid = setInterval (‘intervalProc ()', 500): 
} 
ia 
</script> 
«button onclicks'test();'»TEST«/button» 


«object name-"psp" type-"application/x-psp-extplugin"»«/object» 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 


to run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 


from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioCapabilityCheck, sysRadioSetSubVolume, sysRadioGetLeftAudioPeakLevel , 
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sysRadioGetRightAudioPeakLevel, sysRadioGetRightAudioAverageLevel 
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sysRadioGetRightAudioAverageLevel 


Get average audio level being output from audio right channel 


Syntax 


result = psp. sysRadioGetRightAudioAverageLevel ( [mode] ) 


Identifier for specifying the range of the return value 
(see below) 


Integer value in the range 0. S result = 255 


Integer value in the range 0 
Integer value in the range 0 


result 
result 


32767 
90 


HA Wé 


Arguments 


mode 


Return Value 


When mode is not specified or 
when 0 is specified for mode 
When 1 is specified for mode 
When 2 is specified for mode 


Description 


This extended method gets the average audio output level of the right channel. 


If mode is not specified or if it is specified as 0, the average absolute value at point (A) in 


the figure below is returned as a value in the range 0 to 255. 


If 1 is specified for mode, the average absolute value at the same point in the figure is 


returned as a value in the range 0 to 32767. 


If 2 is specified for mode, the average absolute value at the same point in the figure is 


logarithmically transformed and returned as a value in the range 0 to 90. Specifically, 


processing equivalent to evaluating the following expression is performed internally by the 


PSP™, 
result = Math.floor 


(20 * Math.log (psp.sysRadioGetRightAudioAverageLevel (1) + 1) / Math.log (10)); 
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This method can be used with system software version 5.00 or later. 


Audio 
decoder 


Ge 
hy Pd 

d, 
e| 


sysRadioSetSubVolume | sysRadioSetSineWaveOscillatorFrequencyAndVolume 







uf, 


sysRadioSetWhiteNoiseOscillatorVolume 





^A AS 
LOW HIGH 





sysRadioSetMasterVolume 


sysRadioPlayEffectSound 





Audio output 


Example 


var rightAudioLevel = psp.sysRadioGetRightAudioAverageLevel 0; 


This statement gets the average audio output level of the right channel at point @ in the 


above figure and sets it for rightAudioLevel. 


Sample 
<html><head> 
«meta http-equiv-"content-type" content-"text/html; charset-utf-8"» 
<title>sysRadioGetLeftAudioAverageLevel</title> 
</head> 
<body> 
<hl>sysRadioGetLeftAudioPeakLevel</h1> 
«script languages"JavaSoripb"'.- 
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«e 
window.onload - function () ( setTimeout ('initProc ()', 500); } 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255 255, 30,530,40,96, X 2.3 


psp.sysRadioSetMasterVolume (255); 


) 
var tid = 0: 
function intervalProc () { 


var leftAudioLevel = psp.sysRadioGetRightAudioAverageLevel (); 


psp.sysRadioDebugLog (“left=”" + leftAudioLevel + “\n"”); 


} 


function test () { 
psp.sysRadioPlayStream 
(“http://radio.psp.dl.playstation.net: 80” 
+”/psp/radio/sample/pseudo stream/teststream a.stream.mp3”, 
"pspRadioPlayer”); 


psp.sysRadioSetSubVolume (255); 


if { Cid == ) tid = setInterval (‘intervalProc ()', 500): 
} 
ia 
</script> 
«button onclicks'test();'»TEST«/button» 


«object name-"psp" type-"application/x-psp-extplugin"»«/object» 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created 


to run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 


from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioCapabilityCheck, sysRadioSetSubVolume, sysRadioGetLeftAudioPeakLevel , 
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sysRadioGetRightAudioPeakLevel, sysRadioGetLeftAudioAverageLevel 
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sysRadioSetSineWaveOscillatorFrequen 
cyAndVolume 


Set oscillation frequency and volume level of sine wave oscillator 


Syntax 
psp. sysRadioSetSineWaveOscillatorFrequencyAndVolume 
(freq Í, vol [, tension [, cwtext [, keyingspeed I I I D 
Arguments 
freq Oscillation frequency (0€ freq S 22500; units: Hz) 
vol Volume (0 vol € 255; optional) 
tension Rate of frequency change (0 tension € 255; optional) 
cwtext Morse code text (optional) 
keyingspeed Morse code keying speed (0 S keyingspeed € 32; optional) 


Return Value 


Always 0. 


Description 


This 1s a function for producing a "retro analog radio atmosphere." 


This extended method sets parameters for the sign wave oscillator such as the oscillation 
frequency and amplitude (size of the sound). 

The rate that the frequency changes can be assigned by using £ension. The smaller the 
value of tension, the faster the frequency changes. 

A sign wave can be output as Morse code by assigning a string for cwtext. If "~" 1s inserted 
between characters, keying is connected. The keying speed 1s controlled by using 
keyingspeed. The smaller the value of kevingspeed, the faster the keying speed. 

The volume of sound that is output is determined by the product of the value set by 
sysRadioSetMasterVolume and the value set by 
sysRadioSetSineWaveOscillatorFrequencyAndVolume. 
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Sine wave 
oscillator 


sysRadioSetSub Volume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


ow " HIGH 
sysRadioSetWhiteNoiseOscillatorVolume 


Os 


sysRadioPlayEffectSound 


sysRadioSetMasterVolume 


Audio output 


Example 


psp.sysRadioSetSineWaveOscillatorFrequencyAndVolume 
(880, 80, 100, "CQ CQ CQ DE P~S~P P~S~P P~S~P PSE K ", 3); 


This statement oscillates an 880 Hz sine wave and modulates it by the intermittent pattern 


of Morse code. 


Sample 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioSetSineWaveOscillatorFrequencyAndVolume</title> 
</head> 

<body> 

<hl>sysRadioSetSineWaveOscillatorFrequencyAndVolume</h1> 

<script language="JavaScript"> 


% 1 == 
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window.onload = function () { setTimeout ('initProc ()', 500); } 
function anitProc () I 
psp.sysRadioSetMasterVolume (255); 
} 
Var tid = 0; 
function intervalProc () { 
var freq = 220 + 4000 * Math.random (); 
psp.sysRadioSetSineWaveOscillatorFrequencyAndVolume (freq) 
) 
function test () + 


psp.sysRadioSetSineWaveOscillatorFrequencyAndVolume 


(880, 80, 100, "CQ CQ CQ DE P~S~P P~S~P P~S~P PSEK ", 3); 
if ( tid == ) tid = setInterval ('intervalProc ()', 500); 
) 
ff es 
</SCript> 
«button onclick-'test();'»TEST«/button» 


<object name="psp" type"application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioSetMasterVolume 
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sysRadioSetWhiteNoiseOscillatorVolum 
e 


Set volume level of pseudo white noise oscillator 


Syntax 
psp. sysRadioSetWhiteNoiseOscillatorVolume (vol [, lowF [, highF [, tension ] ] ) 
Arguments 
vol Volume (0€ vol € 255) 
lowF Lower limit of generated frequencies (05 lowF= 255; optional) 
highF Upper limit of generated frequencies (0 ShighF S255, where lowF S 
highF; optional) 
tension Rate of frequency change (0 tension € 255; optional) 


Return Value 


Always 0. 


Description 


This 1s a function for producing a "retro analog radio atmosphere." 


This extended method sets parameters for the pseudo white noise oscillator such as the 
noise frequency band and amplitude (size of the sound). 

The noise frequency band that is generated is controlled by lowF and highF. 

The rate that the frequency band changes can be assigned by using tension. The smaller 
the value of tension, the faster the frequency band changes. 

The volume of sound that is output is determined by the product of the value set by 
sysRadioSetMasterVolume and the value set by sysRadioSetWhiteNoiseOscillatorVolume. 


©SCEI PSP™ Internet Radio Player Development Guide 


- 65 - 













sysRadioSetSubVolume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


sysRadioSetWhiteNoiseOscillator Volume 


White 
e © noise 
= m oscillator 

| e 







4 N 
LOW HIGH 


sysRadioSetMasterVolume 


sysRadioPlayEffectSound 


Audio output 


psp.sysRadioSetWhiteNoiseOscillatorVolume (80, 0, 255, 10); 


This statement generates pseudo white noise. 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioSetWhiteNoiseOscillatorVolume</title> 

</head> 

<body> 

<h1>sysRadioSetWhiteNoiseOscillatorVolume</h1> 

<script. language="JavaScript"> 

<!-- 


window.onload = function () { setTimeout ('initProc ()', 500); } 


PSP™ Internet Radio Player Development Guide 


- 66 - 


Example 


Sample 


OSCEI 


function initProc () { 
psp.sysRadioSetMasterVolume (255); 
} 
var tid = 0; 
function intervalProc () + 
var highF = 15 + 240 * Math.random (): 
psp.sysRadioSetWhiteNoiseOscillatorVolume (80, 0, highF); 
} 
function test () { 


psp.sysRadioSetWhiteNoiseOscillatorVolume (80, 0, 255, 10); 


LE d dug == ) tid = setInterval ('intervalProc ()', 1000); 
} 
[f € 
</script> 
<button onclick='test();'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioSetMasterVolume 
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sysRadioSetAudioShiftWidth 


Set shift width of audio frequency component 


Syntax 


psp. sysRadioSetAudioShiftWidth (val) 


Arguments 


val Shift width (-256 SvalS 256) 
Note) The meaning of this numeric value is an internally defined 
independent entity. The units of this value are not Hz. 


Return Value 


Always 0. 


Description 


This is a simple function for producing a "retro analog radio atmosphere." The sound 


quality of the playback sound is significantly degraded by this processing. 


This function shifts the audio frequency spectrum after the signal that was received from 
the broadcast server is decoded. 


When val z 0, the playback sound is monaural. 


The following figure shows the original audio frequency spectrum. When va/= 0, no 


processing is performed by this method. 
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When val > 0, the sound becomes lower. However, the lower limit of the spectrum's 


frequencies is clipped near 0 Hz (DC). 





ZHO 


f 


When val < 0, the sound becomes higher. However, the upper limit of the spectrum's 


frequencies is clipped near 22.05 kHz. 





The following figure shows the order 1n which processing 1s performed for the frequency 
shift (sysRadioSetAudioShiftWidth), frequency cut off (sysRadioSetAudioCutOffWidth), and 
pitch conversion (sysRadioSetAudioPitchShiftWidth). 

Note that you should avoid applying multiple effects at the same time since each one 


creates a relatively heavy processing load. 
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Audio 
decoder 


audio shift 


audio cut off 





audio pitch shift 


Sub volume © 


psp.sysRadioSetAudioShiftWidth (50); 


This statement shifts the frequency spectrum towards higher frequencies. 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


} 


<title>sysRadioSetAudioShiftWidth</title> 
</head> 

<body> 
<hl>sysRadioSetAudioShiftWidth</h1l> 
<script language="JavaScript"> 


<!-- 


window.onload = function () { setTimeout ('initProc ()', 500); 


function initProc () { 


psp.sysRadioSetMasterVolume (255); 
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Example 


Sample 


OSCEI 


var tid = 0: 
var s = 0; 
function intervalProc () { 


var shiftWidth; 


-50; 


Nn 
ek 
H- 
Fh 
₪ 
= 
H- 
Q 
CT 
D 
1 


shittwidth = 15; 
} 
psp.sysRadioSetAudioShiftWidth (shiftWidth); 
) 
function test () { 
psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"pspRadioPlayer"); 


psp.sysRadioSetSubVolume (100); 


17 ( tid == ) tid = setInterval ('intervalProc ()', 3000); 
) 
ji == 
</script> 
<button onclick='test();'>TEST</button>= 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 


run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 
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See Also 


sysRadioSetAudioCutOffWidth, sysRadioSetAudioPitchShiftWidth 
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sysRadioSetAudioCutOffWidth 


Set cut-off width of audio frequency component 


Syntax 


psp. sysRadioSetAudioCutOffWidth (val) 


Arguments 


val Cut-off width (-256 Sval < 256) 
Note) The meaning of this numeric value is an internally defined 
independent entity. The units of this value are not Hz. 


Return Value 


Always 0. 


Description 


This is a simple function for producing a "retro analog radio atmosphere." The sound 


quality of the playback sound is significantly degraded by this processing. 


This function performs processing that narrows the band of the audio frequency spectrum 
after the signal that was received from the broadcast server is decoded. 


When val z 0, the playback sound is monaural. 


The following figure shows the original audio frequency spectrum. When va/= 0, no 


processing is performed by this method. 
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When val > 0, the high area is cut off. 


D 


When val < 0, the low area is cut off. 


å 


The following figure shows the order in which processing is performed for the frequency 
shift (sysRadioSetAudioShiftWidth), frequency cut off (sysRadioSetAudioCutOffWidth), and 
pitch conversion (sysRadioSetAudioPitchShiftWidth). 

Note that you should avoid applying multiple effects at the same time since each one 


creates a relatively heavy processing load. 


Audio 
decoder 





audio pitch shift 


Sub volume G 
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psp.sysRadioSetAudioCutOffWidth (33): 


This statement cuts off the high area. 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioSetAudioCutOffWidth</title> 

</head> 

<body> 

<h1>sysRadioSetAudioCutOffWidth</h1> 


<script language="JavaScript"> 


= 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc () + 
psp.sysRadioSetMasterVolume (255); 
} 
var tid = 0; 
var s = 0; 
function intervalProc () ( 
var cutOffWidth; 
LE 45 d 
B. m D 
cutoffwidth = -60; 
j 
else { 
s = 1; 
cutOffWidth = 33; 
j 
psp.sysRadioSetAudioCutOffWidth (cutOffWidth); 
} 
function test () { 


psp.sysRadioPlayStream 


("http://radio.psp.dl.playstation.net:80" 
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Example 


Sample 


OSCEI 


+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"pspRadioPlayer"): 


psp.sysRadioSetSubVolume (100); 


if { Cid == ) tid = setInterval ('intervalProc ()', 3000); 
) 
[go e 
</script> 
«Dutton onclick-'test(); »TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 


run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 


from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioSetAudioShiftWidth, sysRadioSetAudioPitchShift Width 
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sysRadioSetAudioPitchShiftWidth 


Set pitch shift width of audio frequency component 


Syntax 


psp. sysRadioSetAudioPitchShiftWidth (val) 


Arguments 


val Pitch shift width C256 val € 250) 
Note) The meaning of this numeric value is an internally defined 
independent entity. The units of this value are not Hz. 


Return Value 


Always 0. 


Description 


This is a simple function for producing a "retro analog radio atmosphere." The sound 


quality of the playback sound 1s significantly degraded by this processing. 


This function changes the audio pitch after the signal that was received from the broadcast 
server is decoded. 


When val z 0, the playback sound is monaural. 


The following figure shows the original audio frequency spectrum. When va/- 0, no 


processing is performed by this method. 
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When val > 0, the sound becomes higher. However, the upper limit of the spectrum's 


frequencies is clipped near 22.05 kHz. 





When val < 0, the sound becomes lower. 





f 


The following figure shows the order in which processing is performed for the frequency 
shift (sysRadioSetAudioShiftWidth), frequency cut off (sysRadioSetAudioCutOffWidth), and 
pitch conversion (sysRadioSetAudioPitchShiftWidth). 

Note that you should avoid applying multiple effects at the same time since each one 


creates a relatively heavy processing load. 
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Audio 
decoder 


audio shift 


audio cut off 


Y 






audio pitch shift 


Sub volume 


psp.sysRadioSetAudioPitchShiftWidth (50); 


This statement shifts the frequency spectrum towards higher frequencies. 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


) 


<title>sysRadioSetAudioPitchShiftWidth</title> 
</head> 

<body> 
<h1>sysRadioSetAudioPitchShiftWidth</h1> 
<script language="JavaScript"> 


<!-- 


window.onload = function () { setTimeout ('initProc ()', 500): 


function initProc (9) 4 


psp.sysRadioSetMasterVolume (255); 


var tid = 0; 


PSP™ Internet Radio Player Development Guide 


- 79 - 


Example 


Sample 


OSCEI 


var ₪ = 0s 
function intervalProc () { 


var pibchsShiftWidth; 


pitchShiftWidth = -20; 


pitchShiftWidth = 20; 
) 
psp.sysRadioSetAudioPitchShiftWidth (pitchShiftWidth); 
) 
function test () + 
psp.sysRadioPlayStream 
("http://radio.psp.dl.playstation.net:80" 
+"/psp/radio/sample/pseudo stream/teststream a.stream.mp3", 
"ospRadioPlayer"); 


psp.sysRadioSetSubVolume (100); 


if { Cid == ) tid = setInterval ('intervalProc ()', 3000); 
} 
e E 
</script> 
<button onelick="test|) i; '>TESTA button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


See Also 


sysRadioSetAudioShiftWidth, sysRadioSetAudioCutOffWidth 
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sysRadioPlayEffectSound 


Play sound effect 


Syntax 


psp. sysRadioPlayEffectSound () 


Arguments 


None. 


Return Value 


Always 0. 


Description 


This extended method plays a clicking sound (like a shutter sound). 
Although the current system software version has only this one type of sound, the number 


of sound variations is expected to increase in future versions. 
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sysRadioSetSubVolume sysRadioSetSineWaveOscillatorFrequencyAndVolume 


sysRadioSetWhiteNoiseOscillatorVolume 


sysRadioSetMasterVolume 


sysRadioPlayEffectSound 
effects 








Audio output 


Example 


psp.sysRadioPlay EffectSound 0; 


This statement plays a sound effect. 


Sample 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioPlayEffectSound</title> 

</head> 

<body> 

<h1>sysRadioPlayEffectSound</h1> 

«script languages"JavaScript"- 

elu 

function test () + 


psp.sysRadioPlayEffectSound (); 
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} 

E sep 

ST EE AE 

«button onclicks-'test();'-TEST«/button» 

<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


None. 
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sysRadioPrepareForHttpGet 


Make preparations for performing HTTP GET for specified URL 


Syntax 
result = psp. sysRadioPrepareForHttpGet 
(url |, userAgentName [, length [, charCodeConvert Option ||] ) 
Arguments 
url Target URL 
userAgentName User agent name (optional) 


Note) If this is omitted, the default value is "Mozilla/4.0 (PSP 
(PlayStation Portable); 2.00)." 

length Maximum size 
Note) The maximum value of 49152 cannot be exceeded. If the 
specification is omitted, the default value will be used for the 
maximum value. 

charCodeConvertOption Character code conversion specification identifier 


0: No conversion processing 
1: Treated as SJIS (CP932) and converted to UTF-8. 
2: Treated as EUC-KR (CP949) and converted to UTF-8. 


Return Value 


0 Normal 
-1 Error 


Description 


This extended method is used for making preparations to access ur/to perform an HTTP 
GET operation and run GET processing in the background. 

The background processing status can be detected by using the sysRadioGetHttpGetStatus 
method. 


Multiple HTTP GET operations cannot be run at the same time. If a new 
sysRadioPrepareForHttpGet method is called when HTTP GET processing is not completed, 
the previous HTTP GET processing is canceled. 
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If there is no free space in the JavaScript extended method processing queue, -1 is returned. 
At this time, the processing request is ignored (discarded). As long as method calls of types 
that are queued are not continuously issued (such as in an endless loop), this state does not 


normally occur. 


The following methods are types that are queued. 


Method Names of Types That Overview 
are Queued 


sysRadioPlayStream Starts playback by specifying URL of audio data stream 
sysRadioPlayPls Starts playback by specifying URL of PLS file 


sysRadioPlayM3u Starts playback by specifying URL of M3U file 
sysRadioPrepareForHttpGet Prepares for performing HTTP GET for specified URL 


sysRadioCaptureScreenShot Captures screenshot 





When the related sysRadioGetHttpGetStatus method returns 1, it means that GET 
processing is still in progress and when it returns 0, it means that GET processing finished. 
The GET result can be obtained by invoking the sysRadioGetHttpGetResult method. 

To release resources that were allocated by internal processing when a sequence of 


processing operations is finished, call the sysRadioHttpGetTerminate method. 


It is assumed that the target data of the HTTP GET operation is a text string and that the 
character encoding of this text string is SJIS. The charCodeConvertOption option is 
provided for converting the character code to UTF-8. This option also supports EUC-KR 
character encoding. The current version does not support any text encoding other than SJIS 


or EUC-KR. 


Example 


var result = psp.sysRadioPrepareForHttpGet 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo stream/testdata0.txt"); 


This statement makes preparations for performing an HTTP GET operation for 
"http:/radio.psp.dl.playstation.net/psp/radio/sample/pseudo stream/testdata0.txt" and 


begins processing in the background. 
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Sample 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioPrepareForHttpGet</title> 

</head> 

<body> 

<h1>sysRadioPrepareForHttpGet</h1> 


<script language="JavaScript"> 


«Ie 
var tid = Ü; 
function timeoutProc () { 
clearTimeout (tid); 
tid. = 0; 
var status = psp.sysRadioGetHttpGetStatus (); 
Switch ( status ) { 
case 0: 
var result = psp.sysRadioGetHttpGetResult (); 
psp.sysRadioHttpGetTerminate (); 
alert ("result=" + result); 
break; 
case 1: 
tid - setTimeout ('timeoutProc ()', 500); 
break; 
default: // error 
psp.sysRadioHttpGetTerminate (); 
break; 
) 
) 
function test () ( 
psp.sysRadioPrepareForHttpGet 
(“http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo stream/testdata0.txt"); 
if (tid == 0 ) tid = setTimeout ('timeoutProc ()', 500); 
} 
tå => 
</Soripl> 
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«button onclick-'test():'2TEST«/buttons 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 
sysRadioGetHttpGetStatus, sysRadioGetHttpGetResult, sysRadioHttpGetTerminate, 
sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u, 
sysRadioCaptureScreenShot 
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sysRadioGetHttpGetStatus 


Get status of sysRadioPrepareForHttpGet processing 


result = psp. sysRadioGetHttpGetStatus () 


Syntax 


Arguments 


None. 


Return Value 


0 HTTP GET processing is completed. 

1 HTTP GET processing is 1n progress. 

1 HTTP GET processing failed. 
Description 


This extended method gets the status of HTTP GET processing that was started by 
sysRadioPrepareForHttpGet. 

Since multiple HTTP GET operations cannot be run at the same time, use this 
sysRadioGetHttpGetStatus method to monitor the processing status to detect that 
processing 1s completed. 

Since processing may fail, you also need to provide suitable error processing as necessary. 
This extended method is not implemented with an event-style mechanism (like the 
generation of a callback when a sequence of HTTP GET processing operations is finished). 
Therefore, the 1mplementation requires that the sysRadioGetHttpGetStatus method be 


called (polled) at appropriate time intervals to check the status. 


var status = psp.sysRadioGetHttpGetStatus 0; 


This statement gets the status of background HTTP GET processing and sets it in the 
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Example 
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variable status. 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


) 


<title>sysRadioGetHttpGetStatus</title> 
</head> 

<body> 
<hl>sysRadioGetHttpGetStatus</hl> 


<script language="JavaScript"> 


> == 
window.onload = function () ( setTimeout ('initProc ()', 500); 
function initProc () ( 

psp.sysRadioSetDebugMode (1); 

psp.sysRadioSetDebugLogTextStyle 

(224,224,224,255, 255,255,255,255, 30,30,40,96, 1,2): 

) 
ver tid = 0; 
function timeoutProc () { 


clearTimeout (tid); 

cag! = 0; 

var status = psp.sysRadioGetHttpGetStatus (); 

psp.sysRadioDebugLog ("status-" + status + "\n"); 

Switch ( status ) { 

case 0: 
var result = psp.sysRadioGetHttpGetResult (); 
psp.sysRadioHttpGetTerminate (); 
psp.sysRadioDebugLog ("result-" + result + "\n"); 
break; 

case 1: 
tid - setTimeout ('timeoutProc ()', 500); 
break; 

default: // error 
psp.sysRadioHttpGetTerminate (); 


break; 
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Sample 
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} 
function test () { 
psp.sysRadioPrepareForHttpGet 
("http://radio.psp.dl.playstation.net" 


+"/psp/radio/sample/pseudo stream/testdata0.txt"); 


if (tid == 0 ) tid = setTimeout ('timeoutProc ()', 10); 
} 
[4 an 
0 - 
«button onclick-'test();' '»TEST«/button-» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioPrepareForHttpGet, sysRadioGetHttpGetResult, sysRadioHttpGetTerminate, 
sysRadioPlayStream, sysRadioPlayPls, sysRadioPlay M3u, 
sysRadioCaptureScreenShot 
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sysRadioGetHttpGetResult 


Get sysRadioPrepareForHttpGet processing result as string 


Syntax 


result = psp. sysRadioGetHttpGetResult () 


Arguments 


None. 


Return Value 


The HTTP GET processing result (string) is returned. 


Description 


This extended method gets a string indicating the result of HTTP GET processing, which 
was started by sysRadioPrepareForHttpGet. 

If the character code conversion option had been specified by the option 
charCodeConvertOption of sysRadioPrepareForHttpGet, this extended method will get the 


character code-converted string. 


This extended method is not implemented with an event-style mechanism (like the 
generation of a callback when a sequence of HTTP GET processing operations is finished). 
Therefore, the implementation requires that the sysRadioGetHttpGetStatus method be 
called (polled) at appropriate time intervals to check the status and the 
sysRadioGetHttpGetResult method be called when processing is completed. 


Example 


var result = psp.sysRadioGetHttpGetResult 0; 
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This statement gets the result of background HTTP GET processing as a string and sets it 


in the variable result. 


Sample 


<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetHttpGetResult</title> 
</head> 
<body> 
<h1>sysRadioGetHttpGetResult</h1> 
<script language="JavaScript"> 
ie 
var tid = U; 
function timeoutProc () + 
clearTimeout (tid); 
Eid > 0, 
var status = psp.sysRadioGetHttpGetStatus (); 
switch ( status ) { 
case 0: 
var result = psp.sysRadioGetHttpGetResult (); 
psp.sysRadioHttpGetTerminate (); 
alert ("result=" + result); 
break; 
case 1: 
tid - setTimeout ('timeoutProc ()', 500); 
break; 
default: // error 
psp.sysRadioHttpGetTerminate (); 


break; 


} 


function test () { 
psp.sysRadioPrepareForHttpGet 
("http://radio.psp.dl.playstation.net" 


+"/psp/radio/sample/pseudo stream/testdata0.txt"); 
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1f (tid == ) tid = setTimeout ('timeoutProc ()', 500); 


} 

fp =e 

</script> 

«button onclicks'test(); '»TEST«/button» 

<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioPrepareForHttpGet, sysRadioPrepareForHttpGet, sysRadioHttpGetTerminate, 
sysRadioPlayStream, sysRadioPlayPls, sysRadioPlay M3u, 
sysRadioCaptureScreenShot 
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sysRadioHttpGetTerminate 


Perform sysRadioPrepareForHttpGet housekeeping 


Syntax 


psp. sysRadioHttpGetTerminate () 


Arguments 


None. 


Return Value 


None. 


Description 


This extended method completes HTTP GET processing, which was started by 
sysRadioPrepareForHttpGet. 

To release resources that were allocated by 1nternal processing after a sequence of 
operations that began with sysRadioPrepareForHttpGet is finished (after the result was 
obtained by sysRadioGetHttpGetResult), call the sysRadioHttpGetTerminate method to 


complete the processing. 


Example 
psp.sysRadioHttpGetTerminate 0; 
This statement completes background HTTP GET processing, and releases internal 
resources. 
Sample 
<html><head> 
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<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioHttpGetTerminate</title> 

</head> 

<body> 

<h1>sysRadioHttpGetTerminate</h1> 


<script language="JavaScript"> 


«ee 
Var Cid ל‎ 
function timeoutProc () { 
clearTimeout (tid); 
tid = Os 
var status = psp.sysRadioGetHttpGetStatus (); 
switch ( status ) { 
case 0: 
var result = psp.sysRadioGetHttpGetResult (); 
psp.sysRadioHttpGetTerminate (); 
alert ("result = " + result); 
break; 
case 1: 
tid - setTimeout ('timeoutProc ()', 500); 
break; 
default: // error 
psp.sysRadioHttpGetTerminate (): 
break; 
) 
) 
function test () + 
psp.sysRadioPrepareForHttpGet 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo stream/testdata0.txt"); 
if (tid == 0 ) tid = setTimeout ('timeoutProc ()', 500); 
} 
pf oer 
</script> 
«button onclicks'test();'»TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 
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See Also 


sysRadioPrepareForHttpGet, sysRadioGetHttpGetStatus, sysRadioGetHttpGetResult, 
sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u, 
sysRadioCaptureScreenShot 
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sysRadioGetPlayerStatus 


Get internal status of player system 


Syntax 


result = psp. sysRadioGetPlayerStatus () 


Arguments 


None. 


Return Value 


0 No processing is being performed. 

1 Audio data stream 1s being played. 

2 PLS or M3U data 1s being obtained. 

3 PLS or M3U data is being parsed. 

4 Connecting to the broadcast server. 

“1 Some kind of error occurred. 
Description 


This extended method gets the internal status of the PSP™ Internet radio player core 
system while an audio stream is being received. 

The value returned by this method can be used to switch the GUI display to display the 
radio status for the user, to reconnect when an error occurs during internal processing of 


the Internet radio player, or to attempt to connect to a different broadcast station. 


The PSP™ Internet radio system has a processing structure that performs low-level 
automatic error recovery and reconnection processing. Part of the operation status of this 


processing is reflected in the return value of sysRadioGetPlayerStatus. 


Example 


var status = psp.sysRadioGetPlayerStatus (); 
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This statement gets the internal status of the player system and sets it in the variable 


status. 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


} 


<title>sysRadioGetPlayerStatus</title> 
</head> 
<body> 
<h1>sysRadioGetPlayerStatus</h1> 
<script language="JavaScript"> 
<!-- 
window.onload = function () { setTimeout ('initProc ()', 500); 
function anitPbroc 6( 4 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,221,224,255, 255,255/255,2555, 20.30.60 2068 1 [3 
psp.sysRadioSetMasterVolume (255); 
} 
var tid = 0; 
function intervalProc () { 
var status = psp.sysRadioGetPlayerStatus (); 
psp.sysRadioDebugLog ("status=" + status + "Nn"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 


psp.sysRadioSetSubVolume (255); 


if (. tid s2 0 ) tid - setlInterval ('intervalProc ()', 250); 


) 
fy ==> 
</script> 


<button onclick="test():'>TEST</button> 
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Sample 
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<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u, sysRadioStop 
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sysRadioGetNetworkBandQuality 


Get communication circuit band quality evaluation value 


result = psp. sysRadioGetNetworkBandQuality () 


syntax 


Arguments 


None. 


Return Value 


An integer value in the range OE result € 255 1s returned. 


Description 


This extended method returns an integer value that is 255 times the ratio of the measured 
value or, more specifically, the measured band of the network's transmission quality and 


the assumed band. 


Generally, if the Internet radio audio data stream fills the assumed band on average, its 
playback sound will not be interrupted. However, if the transmission band becomes 
narrower as the accumulated data 1n the internal buffer runs out, intermittent sound may 
occur even if the bandwidth had been filled on average. 

The value returned by sysRadioGetNetworkBandQuality 1s an indicator of the status 1n 


which this 1ntermittent sound occurs. 


Normally, the status of the broadcast server and status of the network channel are 
influenced by similar factors, and fluctuations occur in the actual transmission band. As a 
result, there are also moments when the band 1s wider than the assumed band. 

Even when the band had been wider than the assumed band, the comparison of the 
measured band and assumed band is returned as a value that 1s clipped by a value 


corresponding to the upper limit 1.0 or, in other words, clipped by 255. 
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Example 


var result = psp.sysRadioGetNetworkBandQuality Q; 


This statement gets the network transmission quality and sets it in the variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetNetworkBandQuality</title> 
</head> 
<body> 
<hl>sysRadioGetNetworkBandQuality</h1l> 
<script. language="JavaScript”"> 
1 == 
window.onload = function () ( setTimeout ('initProc ()', 500); j 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,220,224,255, 255,255,255,255,. 30,30,40,96. lp 2) 
psp.sysRadioSetMasterVolume (255); 
) 
var tid = 0; 
function intervalProc () { 
var result - psp.sysRadioGetNetworkBandQuality (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
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it ( Lid == 0 ) tid = sétInterval ("intervalPros ()", 500): 
) 
[f = 
«script> 
«button onclicks'test(); '»TEST«/button» 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 


run this sample code. 


Since it is not a genuine SHOUTcast or 1cecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


Execution Result 


sysRadioGetNetworkBandQuality 


=a 


window.onload = function () { setTimeout (‘initProc ()', 500); } 
function initProc () I 
psp.sysRadioSetDebugMode (1): 
psp.sysRadioSetDebugLosTextStyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 
psp.sysRadioSetMasterV olume (255); side 
} 
var tid = O; 
function intervalProc () 1 
var result = psp.sysRadioGetNetworkBandQuality (); 
psp.sysHadioDebugL og ("result-" + result + ^n"); 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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sysRadioGetAudioSoundDistortionRate 


Get audio distortion rate (saturation of sound) 


Syntax 


result = psp. sysRadioGetAudioSoundDistortionRate () 


Arguments 


None. 


Return Value 


An integer value in the range OE result € 255 1s returned. 


Description 


This extended method returns the content by percentage of high-level sound samples that 
saturate the dynamic range, within the set of data generated from the decoding of the audio 
data stream 

Specifically, the returned value is an integer value that is 255 times the ratio of the number 
of data in a certain fixed interval and the number of high level value (saturation value) 
data contained in them. 


The closer this value 1s to 0, the higher the sound quality. 


This value changes instantaneously as the numeric value gets larger and slowly as the 


numeric value gets smaller so that even momentary sound distortion can be detected. 


Example 
var result = psp.sysRadioGetAudioSoundDistortionRate 0; 
This statement gets the sound distortion rate and sets it in the variable result. 
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<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


) 


<title>sysRadioGetAudioSoundDistortionRate</title> 
</head> 

<body> 
<h1>sysRadioGetAudioSoundDistortionRate</h1> 


<script language="JavaScript"> 


«e 
window.onload = function () { setTimeout ('initProc ()', 500); 
function initProc )( ( 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255,. 30,30,10/96, 1,2); 
psp.sysRadioSetMasterVolume (255); 
} 
var tid =. 0; 
function intervalProc () { 
var result - psp.sysRadioGetAudioSoundDistortionRate (); 
psp.sysRadioDebugLog ("result-" + result + "\n"); 
) 
function test () + 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
1f ( tid == 0 ) tid = setInterval ('intervalProc ()', 500); 
} 
pj <-> 
</SCri ot 
<button onclick="test();'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 
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Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


Execution Result 


sysRadioGetAudioSoundDistortionRate 


CR ES 
window.onload = function () | setTimeout ('initProc ()', 500); } 
function initProc () I 
psp.sysRadioSetDebugMode (1); 
psp.sysHadioSetDebugL ogTextStyle 
(224224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 
psp.sysRadioSetMasterV olume (255); - 
} 
var tid = O; 
function intervalProc () { 
var result = DSp.sysRadioGetAudioSoundDistortionRate EMI 
psp.sysHadioDebugL og ("result-" + result + ^n"); 15-בו‎ 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 


©SCEI PSP™ Internet Radio Player Development Guide 


- 105 - 


sysRadioGetContentMetalnfo 


Get content meta information for audio data stream being played 


Syntax 


result = psp. sysRadioGetContentMetalnfo ( | charCodeConvertOption | ) 


Arguments 


charCodeConvertOption Character code conversion specification identifier (optional) 
0: No conversion processing 
1: Treated as SJIS (CP932) and converted to UTF-8. 
2: Treated as EUC-KR (CP949) and converted to UTF-8. 


Return Value 


A content meta information string 1s returned. 


Description 


This extended method gets the meta information string of the content that 1s being played. 
Generally, this string is in "artist information/song name information" format. 


By specifying the charCodeConvertOption option, you can get a character code-converted 
string. In the current state of Internet radio broadcasts, SJIS 1s often used for Japanese 
songs and EUC-KR 1s often used for Korean songs. By determining the character encoding 
method that is being used in the received audio data stream and performing the 
appropriate character code conversion in advance, you can prevent characters from being 


garbled in the content meta information as much as possible. 


Since there is no clear agreement related to text encoding contained in content meta 
information, the PSP™ Internet radio system has no mechanism for automatically 


detecting the encoding method of non-Latin-1 text and switching or converting it. 
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Example 


var result = psp.sysRadioGetContentMetalnfo 0; 


This statement gets the content meta information of the content that is being played and 


sets 1t 1n the variable result. 


Sample 


<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetContentMetaInfo</title> 
</head> 
<body> 
<h1>sysRadioGetContentMetalnfo</h1> 
«script languages"JavaScript"- 
<!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); j 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224;255, 255,255,255,255, :30,30,40,95, 1) 2)3 
psp.sysRadioSetMasterVolume (255); 
) 
var tid = 0; 
function intervalProc () { 
var result = psp.sysRadioGetContentMetaInfo (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 


if ( tid == 0 ) tid = setInterval ('intervalProc ()', 1000): 
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j 

E sep 

ST EE AE 

«button onclick-'test();'»TEST«/button» 

<object name="psp" type="application/x-psp-extplugin"></object> 


</body></7html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 


run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


Execution Result 


sysRadioGetContentMetalnfo 


window.onload - function () | setTi 
function initProc () { 


psp.sysHadioSetDebugL ogTe 


(224,224,224,255, 255,255 ÈS ma / 
psp.sysRadioSetMaster V olume (Massilia (s a UT UC Sian 


} resuit-Yuta Kimura «Green 
var tid = Q; result=Y uta Kimura «Green 
function intervalProc () { uta Ki 
var result - psp.sysRadioGetConten Mie 
psp.sysRadioDebugLog ("result-" « resz2* 15 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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sysRadioGetBitRate 


Get bit rate of stream being played 


Syntax 


result — psp. sysRadioGetBitRate () 


Arguments 


None. 


Return Value 


An integer value in the range OE result € 320,000 is returned. 


Description 


This extended method gets the bit rate of the audio data stream that 1s being played. 


If the Internet radio player is not connected, 0 is returned. 


Example 


var result = psp.sysRadioGetBitRate 0; 


This statement gets the bit rate value and sets it 1n the variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetBitRate</title> 
</head> 
<body>» 
<h1>sysRadioGetBitRate</h1> 
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<script language="JavaScript"> 
== 
window.onload = function )( ( setTimeout ('initProc ()', 500); ) 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255, 30,50,40,9%6, L, 2); 
psp.sysRadioSetMasterVolume (255); 
) 
var tid = 0; 
function intervalProc () ( 
var result = psp.sysRadioGetBitRate (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 


psp.sysRadioSetSubVolume (255); 


17 | 616 == ) tid = setInterval ('intervalProc ()', 1000); 
} 
E ës 
נש‎ 
«button onclick-'test(); '»TEST«/button- 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 
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Execution Result 


sysRadioGetBitRate 


LR 
window.onload = function () { setTimeout (‘initProc ()', 500); } 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, By aant 
psp.sysHadioSetMasterV olume (255); 
} 
var tid = O; 
function intervalProc () 1 
var result = psp.sysRadioGetBitRate (); 
psp.sysHadioDebugL og ("result-" « result + ^n"); 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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sysRadioGetSamplingRate 


Get sampling rate value of stream being played 


Syntax 


result = psp. sysRadioGetSamplingRate () 


Arguments 


None. 


Return Value 


An integer value in the range 0S result = 48,000 is returned. 


Description 


This extended method gets the sampling rate of the audio data stream that is being 
received. 


If the Internet radio player is not connected, 0 is returned. 


Example 


var result = psp.sysRadioGetSamplingRate 0: 


This statement gets the sampling rate and sets it in the variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetSamplingRate</title> 
</head> 
<body> 
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<h1>sysRadioGetSamplingRate</h1> 
<script language="JavaScript"> 
ml ee 
window.onload - function () ( setTimeout ('initProc ()', 500); j 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224/224,255, 255,255,255,255, 30,30,40,96, l; 293 
psp.sysRadioSetMasterVolume (255); 
) 
var tid = 0: 
function intervalProc () ( 
var result - psp.sysRadioGetSamplingRate (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 


psp.sysRadioSetSubVolume (255); 


Lt % tad == ) tid = setInterval ('intervalProc ()', 1000); 
} 
[f ==< 
</script> 
«button onclrcks'test();' »TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 
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Execution Result 


sysRadioGetSamplingRate 


IER | 


window.onload - function () | setTimeout ('initProc ()', 500); } 
function initProc () 1 
psp.sysRadiosetDebugMode (1); 
psp.sysHadioSetDebugL ogr extstyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 
psp.sysRadiosetMasterV olume (255); 
; 
var tid = O; 
function intervalProc () { 
var result = psp.sysRadioGetSamplingRate (); 
psp.sysHadioDebugL og ("result-" « result + ^n"); 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 


©SCEI PSP™ Internet Radio Player Development Guide 


- 114 - 


sysRadioGetStreamUri 


Get URL of stream being played 


Syntax 


result = psp. sysRadioGetStreamUrl () 


Arguments 


None. 


Return Value 


The URL string of the broadcast server is returned. 


If the Internet radio player is not connected, a string with length 0 is returned. 


Description 


This extended method enables you to get the URL of the broadcast server from which the 
sysRadioPlayPls and sysRadioPlayM3u methods receive data. It enables you to know the 
actual URL of the broadcast server that is being used for the connection when multiple 
broadcast servers are specified in one PLS or M8U file. 

Of course, even when the Internet radio player is connected with sysRadioPlayStream, you 
can get the URL using sysRadioGetStream Url in a similar manner as if another connection 


method were used. 


Example 


var result = psp.sysRadioGetStreamUrl (); 


This statement gets the URL string of the broadcast server that the Internet radio player is 


connected to and sets it in the variable result. 
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<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetStreamUrl</title> 

</head> 

<body> 

<h1>sysRadioGetStreamUrl</h1> 


<script language="JavaScript"> 


«e 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc )( ( 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255,. 30,30,10/96, 1,2); 
psp.sysRadioSetMasterVolume (255); 
} 
var tid =. 0; 
function intervalProc () { 
var result = psp.sysRadioGetStreamUrl (); 
psp.sysRadioDebugLog ("result-" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"ospRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
if ( tid == 0 ) tid = setInterval ('intervalProc ()', 1000); 
) 
pj <-> 
&JBOFIDD 
«button onclicks'test(); '»TEST«/button-» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 
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Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


Execution Result 


sysRadioGetStreamuri 


IER | 


window.onload = function () { setTimeourt (‘initProc ()', 500); } 
function initProc () | 
psp.sysRadioSetDebugMode (1): 
psp.sysRadioSetDebugLogT extStyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 
psp.sysRadioSetMasterVolume (255), 
! 
var tid = Q; 
function intervalProc () 1 
var result = psp.sysRadig 


psp.sysHadioDebugL og ('result-" + ב ו‎ Kne ITE äis IT mE D 





sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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See Also 
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sysRadioGetStream Title 


Get title information of stream being played 


Syntax 


result — psp. sysRadioGetStreamTitle () 


Arguments 


None. 


Return Value 


The stream title information string is returned. 


If the Internet radio player is not connected, a string with length 0 is returned. 


Description 


This extended method gets the title information string (generally, the broadcast station 


name) of the audio data stream that is being received. 


Example 


var result = psp.sysRadioGetStreamTitle 0; 


This statement gets the title information string of the audio data stream that is being 


received and sets it in the variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetStreamTitle</title> 
</head> 
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<body> 
<h1>sysRadioGetStreamTitle</h1> 
«script Jlanguage-" JavaScript" 
<!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); j 
function initProc () ( 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(424,220) 224, 255% 255,255; 255,205; 30,30,40,96, li 2); 
psp.sysRadioSetMasterVolume (255); 
} 
var tid = 0: 
function intervalProc () ( 
var result = psp.sysRadioGetStreamTitle (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.pesp.dliplavstatron.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 


psp.sysRadioSetSubVolume (255); 


if { Eid == ) tid = setInterval ('intervalProc ()', 1000); 
) 
CZ ==> 
=/SCripc> 
<butten onclick='test() ;'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 
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Execution Result 


sysRadioGetStreamTitle 
IR 
window.onload - function () | setTimeout ('initProc ()', 500); } 


function initProc () 1 
psp.sysRadioSetDebugMode (1); 


psp.sysHadioSetDebugL ogT extstyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 
psp.sysRadioSetMasterVolume (255), 


: 

var tid = O; 

function intervalProc () 1 
var result = psp.sysRadioG 
psp.sysHadioDebugL og ("resu 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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sysRadioGetRelatedPageUrl 


Get related Web page URL string of stream being played 


result = psp. sysRadioGetRelatedPageUrl () 


syntax 


Arguments 


None. 


Return Value 


The related page's URL string is returned. 


If the Internet radio player is not connected, a string with length 0 is returned. 


Description 


This extended method gets the URL of a Web page that is related to the audio data stream 
that is being received. 


If there is no related Web page information, a string with length 0 is returned. 


By displaying the URL that is returned by this method on a separate tab of the PSP™ 
Internet browser, you can implement a mechanism in the Internet radio player that 


enables the user to access a page related to the broadcast while receiving the broadcast. 


There are various forms that this broadcast-related Web page that 1s provided by the 
broadcast station can take such as a request form or bulletin board service (BBS), not just a 


Web page for introducing the broadcast station itself. 


By providing the Internet radio player with a means of accessing these kinds of pages, a 
single PSP™ system can be used to perform all actions such as requesting songs from a 


request form or accessing a BBS while receiving the broadcast. 
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Example 


var result = psp.sysRadioGetRelatedPageUrl 0; 


This statement gets the URL string of a Web page that is related to the broadcast that is 


being received and sets it in the variable result. 


Sample 


<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetRelatedPageUrl</title> 
</head> 
<body> 
<h1>sysRadioGetRelatedPageUrl</h1> 
«script languages"JavaScript"- 
<!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); j 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224;255, 255,255,255,255, :30,30,40,95, 1) 2)3 
psp.sysRadioSetMasterVolume (255); 
) 
var tid = 0; 
function intervalProc () { 
var result = psp.sysRadioGetRelatedPageUrl (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 


if ( tid == 0 ) tid = setInterval ('intervalProc ()', 1000): 
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} 

E sep 

ST EE AE 

«button onclicks-'test();'--TEST«/button» 

<object name="psp" type="application/x-psp-extplugin"></object> 


</body></7html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 


run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


Execution Result 


sysRadioGetRelatedP ageUri 


=. 


window.onload = function () { setTimeout (‘initProc ()', 500); } 
function initProc () I 
psp.sysRadiosetDebugMode (1); 
psp.sysRadiosSetDebugLogT extStyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 
psp.sysHadioSetMasterV olume (255); 
} 
var tid = O; 
function intervalProc () 1 
var result - psp.sysRadioGetRelatedP ag eUri 0 
psp.sysHadioDebugL og ('result-" + resultzz 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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sysRadioGetStreamlpAddress 


Get IP address of broadcast server of stream being played 


Syntax 


result = psp. sysRadioGetStreamlpAddress () 


Arguments 


None. 


Return Value 


The IP address string of the broadcast server from which the audio data stream 1s being 
received (to which the Internet radio player is connected) is returned. 


If the Internet radio player is not connected, a string with length 0 is returned. 


Description 


This extended method gets the IP address of the broadcast server from which the audio 
data stream is being received in "X.X.X.X" string format, which consists of four numeric 


values separated by periods. 


Example 
var result = psp.sysRadioGetStreamIpAddress 0: 
This statement gets the IP address of the broadcast server to which the Internet radio 
player is connected and sets it in the variable result. 
Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
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<title>sysRadioGetStreamIpAddress</title> 
</head> 
<body> 
<hl>sysRadioGetStreamIpAddress</h1l> 
<script language="JavaScript"> 
«las 
window.onload = function () { setTimeout ('initProc ()', 500); ) 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255, 30,50,40;-96, il; 2)4 
psp.sysRadioSetMasterVolume (255); 
} 
var tid = 0}; 
function intervalProc () { 
var result - psp.sysRadioGetStreamIpAddress (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"ospRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
if ( tid == 0 ) tid = setInterval ('intervalProc ()', 1000); 
} 
fy => 
</script> 
ebutton onclick-'test(); »TEST«/button» 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 


run this sample code. 


Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 


from an actual server in that playback always begins from the same timecode position 
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immediately after connection, for example. 


Execution Result 


sysRadioGetStreamipAddress 


SEI 000000000 
window.onload - function () | setTimeout ('initProc ()', 500); } 
function initProc () I 
psp.sysHadioSetDebugMode (1); 
psp.sysRHadioSetDebugL ogT extStyle 
(224224,224,255, 255,255,255,255, 30,30,40,96, 1, 2): 
psp.sysHadioSetMasterV olume (255); 
} 
var tid = O; 
function intervalProc () 1 
var result = psp.sysRadioGetStreamipAddress (); 


psp.sysHadioDebugL og ("result-" « result + hresut=203.77 186.171 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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sysRadioGetStreamPort 


Get connection port number of broadcast server of stream being played 


Syntax 


result = psp. sysRadioGetStreamPort () 


Arguments 


None. 


Return Value 


The port number (integer value) is returned. 


If the Internet radio player is not connected, 0 is returned. 


Description 


This extended method returns an integer value indicating the port number used for the 
connection to the broadcast server from which the audio data stream is being received (to 


which the Internet radio player is connected). 


Example 
var result = psp.sysRadioGetStreamPort 0; 
This statement gets the port number that is being used for the connection to the broadcast 
server and sets it in the variable result. 

Sample 
<html><head> 
«meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetStreamPort</title> 
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</head> 
<body> 
<hl>sysRadioGetStreamPort</h1> 
<soript language="JavaScript"> 
== 
window.onload = function () ( setTimeout ('initProc ()', 500); } 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, :255,255,255,255, 30,30,40,96, 1.7213 
psp.sysRadioSetMasterVolume (255); 
) 
var Cid = 0; 
function intervalProc () + 
var result - psp.sysRadioGetStreamPort (); 
psp.sysRadioDebugLog ("result=" + result + "\n"); 
) 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 


psp.sysRadioSetSubVolume (255); 


17 4 trig == ) tid = setInterval ('intervalProc ()', 1000); 
} 
CZ we 
</SCript> 
«button onclicks'test(); »TEST«c/button- 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or icecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 
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Execution Result 


sysRadioGetStreamPort 


ES‏ נש 
window.onload = function () { setTimeout (‘initProc ()', 500); }‏ 
function initProc )( {‏ 
psp.sysHadioSetDebugMode (1 );‏ 
psp.sysHadioSetDebugL ogT extStyle‏ 
(2QA, 22A, 224,255, 255,255,255,255, 30,30,40,965, 1, 2);‏ 
psp.sysHadioSetMasterV olume (255);‏ 
} 
var tid = O;‏ 
function intervalProc () 1‏ 
var result - psp.sysRadioGetStreamP ort ();‏ 
psp.sysHadioDebugL og ("result-" « result 4 ^n");‏ 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 
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sysRadioGetStreamBufferLevel 


Get level indicating residual amount of stream buffer 


result = psp. sysRadioGetStreamBufferLevel () 


syntax 


Arguments 


None. 


Return Value 


An integer value in the range OE result € 255 1s returned. 


Description 


This extended method returns a value that is calculated from both the amount of data 
(before it was decoded) that is accumulated in an internal buffer from the data stream 
received from the broadcast server and the amount of data after it was decoded to PCM 
data. 

Although the range of the return value is noted above under "Return Value", since the 
audio 1s always playing continuously and data in the buffer is continuously being consumed 
when it is present, the upper limit of 255 is not actually reached and the return value 
typically varies in the range of approximately 30 to 70 when the data can be played 
normally (without intermittent sound). When this value is small, the sound may be 


interrupted (the sound may be softer). 


The value returned by this method is approximate, not one of strict precision. 


var result = psp.sysRadioGetStreamBufferLevel 0: 


This statement gets the amount of data that has accumulated in the buffer and sets it in 
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Example 
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the variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetStreamBufferLevel</title> 
</head> 
<body> 
<h1>sysRadioGetStreamBufferLevel</h1> 
<script language="JavaScript"> 
<les 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,2241,224,255, 255,255,255,255, 30,30,40,96, 1,2): 
psp.sysRadioSetMasterVolume (255); 
) 
var tid = 0; 
function intervalProc () { 
var result = psp.sysRadioGetStreamBufferLevel (): 
psp.sysRadioDebugLog ("result-" + result + "\n"); 
} 
function test () { 
psp.sysRadioPlayPls 
("http://radio.psp.dl.playstation.net" 
+"/psp/radio/sample/pseudo_stream/teststream0.pls", 
"pspRadioPlayer", 
"pspRadioPlayer"); 
psp.sysRadioSetSubVolume (255); 
if ( tid == 0 ) tid = setInterval ('intervalProc ()', 1000); 
} 
Jå => 
ד‎ 
«pubton onclricks'test(); -TEST«/button» 
<object name="psp" type="application/x-psp-extplugin"></object> 
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</body></html> 


Note) The URL in the sample code accesses a "pseudo broadcast server" that was created to 
run this sample code. 

Since it is not a genuine SHOUTcast or 1cecast2 broadcast server, its behavior will differ 
from an actual server in that playback always begins from the same timecode position 


immediately after connection, for example. 


Execution Result 


sysRadioGetStreamBufferLevel 


4 


window.onload = function () { setTimeout (‘initProc ()', 500); } 
function initProc )( { 
psp.sysHadioSetDebugMode (1); 
psp.sysHadioSetDebugL ogTextStyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 
psp.sysHadioSetMasterV olume (255); 
} 
var tid = O; 
function intervalProc () 1 
var result - psp.sysRadioGetStreamBufferL evel (); 
psp.sysHadioDebugL og ("result-" « result « ^n"); 





See Also 


sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u 


©SCEI PSP™ Internet Radio Player Development Guide 


- 189 - 


sysRadioPrepareForScanDir 


Prepare for directory entry scan on a Memory Stick Duo™ 


syntax 


psp. sysRadioPrepareForScanDir ( | path | ) 


Arguments 


path Pathname (optional) 
If this is omitted, the root directory "/" 1s assumed to be specified. 


Return Value 


0 Normal termination 
1 Error (the directory specified in the argument does not exist, etc.) 


Description 


This extended method uses the argument path to specify the directory name on 8 
Memory Stick Duo™ that is to be scanned by the sysRadioScanDir method. 


This method is required as preparation before a sysRadioScanDir method call. 


By using the methods that perform a directory entry scan (sysRadioPrepareForScanDir, 
sysRadioScanDir, and sysRadioGetMediaInOutStatus), you can implement a type of 
Internet radio player that creates a list of broadcast stations from a list of PLS or M3U files 
that were placed on the Memory Stick Duo™ and displays the list of broadcast stations in a 


menu from which the user can make a selection. 


Example 
var result = psp.sysRadioPrepareForScanDir ("/RADIO/PLAYLIST"); 
This statement prepares for scanning the directory "/RADIO/PLAYLIST" ona 
Memory Stick Duo™. 
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<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


) 


<title>sysRadioPrepareForScanDir</title> 
</head> 

<body> 
<h1>sysRadioPrepareForScanDir</h1> 


<script language="JavaScript"> 


<!-- 
window.onload = function () { setTimeout ('initProc ()', 500); 
function initProc () + 

psp.sysRadioSetDebugMode (1); 

psp.sysRadioSetDebugLogTextStyle 

(2405224; 22472505) 255,055,255,0555, 30 30 20 06 1,2); 

} 
function test () { 


psp.sysRadioPrepareForScanDir ("/PSP/RADIOPLAYER"); 
while ( true ) ( 

var filename = psp.sysRadioScanDir (); 

if ) filename.length == 0 ) ( 


var status = psp.sysRadioGetMediaInOutStatus (); 


Switch ( status ) { 

case 0: 
psp.sysRadioDebugLog ("-- END --\n"); 
break; 

case 1: 


psp.sysRadioDebugLog 
("Memory Stick was ejected.\n"); 
break; 
case 2: 
psp.sysRadioDebugLog 
("Memory Stick Duo was re-connected.\n"); 


break; 


break; 
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Sample 
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} 


psp.sysRadioDebugLog ("file: " + filename + "\n"); 


} 

[^ 9-5 

>< 

«button onclicks'test();'-TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioScan Dir, sysRadioGetMedialnOutStatus 
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sysRadioScanDir 


scan directory and return file entry (filename) that was found 


syntax 


result = psp. sysRadioScanDir () 


Arguments 


None. 


Return Value 


A file entry (filename) string is returned. 
If the length of the returned string is 0, it means that the scan finished or that an error 


occurred. 


Description 


This extended method scans the directory that was set by sysRadioPrepareForScanDir and 
returns the filename that was found. By repeatedly calling this method, you can get the 


filenames of all files that are contained in the directory. 


By using the methods for performing a directory entry scan (sysRadioPrepareForScanDir, 
sysRadioScanDir, and sysRadioGetMediaInOutStatus), you can implement a type of 
Internet radio player that creates a list of broadcast stations from a list of PLS or M3U files 
that were placed on a Memory Stick Duo™ and displays the list of broadcast stations in a 


menu from which the user can make a selection. 


Example 


var filename = psp.sysRadioScanDir 0: 


This statement scans the directory that was set by sysRadioPrepareForScanDir and sets 
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the entry name (filename) that was found in the variable filename. 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


) 


<title>sysRadioScanDir</title> 
</head> 

<body> 
<h1>sysRadioScanDir</h1> 


<script language="JavaScript"> 


«lec 
window.onload - function () ( setTimeout ('initProc ()', 500); 
function initProc () ( 

psp.sysRadioSetDebugMode (1); 

psp.sysRadioSetDebugLogTextStyle 

(224,2241,224,255, 255,255,255,255, 30,30,40,96, 1,2): 

} 
function test () { 


psp.sysRadioPrepareForScanDir ("/PSP/RADIOPLAYER") ; 
while ( true ) { 

var filename = psp.sysRadioScanDir (): 

if ( filename.length == 0 ) { 


var status = psp.sysRadioGetMediaInOutStatus )( ; 


Switch ( status ) { 

case 0: 
psp.sysRadioDebugLog ("-- END --\n"); 
break; 

case 1: 


psp.sysRadioDebugLog 
("Memory Stick was ejected.\n"); 
break; 
case 2: 
psp.sysRadioDebugLog 
("Memory Stick Duo was re-connected.Mn"); 


break; 
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break; 


} 


psp.sysRadioDebugLog ("file: " + filename + "\n"); 
} 
} 
[I ==> 
=/SCripc> 
«button onclick="test();'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Execution Result 


sysRadioScanDir 


ES‏ בש 
window.onload = function () | setTimeout ('initProc ()', 5OOJ; |‏ 
function initProc () 1‏ 
psp.sysRadioSetDebugMode (1);‏ 
psp.sysRadioSetDebugLogT extStyle‏ 
:)2 ,1 ,30,30,40,96 ,255,255,255,255 ,224,224,224,255( 
} 
TINOTN‏ ו function test () { Tile‏ 
psp.sysRadioPrepareForScanDir (""PS41zM Tag ET el ad Eh ya "ja‏ 
while ( true ) { |‏ 
var filename = psp.sysRadioScan‏ 
if ( filename.length == O) |‏ 


ar Stat = 9050 Ra dioscetMediainwvy 





See Also 


sysRadioPrepareForScanDir, sysRadioGetMediaInOutStatus 
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sysRadioGetMedialnOutStatus 


Detect whether a Memory Stick Duo™ was inserted or removed 


result = psp. sysRadioGetMedialnOutStatus () 


syntax 


Arguments 


None. 


Return Value 


0 Memory Stick Duo™ has not been inserted or removed. 
1 Memory Stick Duo™ was removed. 
2 Memory Stick Duo™ was reinserted. 

Description 


This extended method enables you to detect the current status of the Memory Stick Duo™ 
and whether it was inserted or removed since the sysRadioPrepareForScanDir method call. 
By using the methods for performing a directory entry scan (sysRadioPrepareForScanDir, 
sysRadioScanDir, and sysRadioGetMediaInOutStatus), you can implement a type of 
Internet radio player that creates a list of broadcast stations from the list of PLS or M3U 
files that were placed on a Memory Stick Duo™ and displays the list of broadcast stations 
in a menu from which the user can make a selection. 

This method is used in an implementation that detects whether the Memory Stick Duo™ 
was inserted or removed during a file search and performs retry processing after it was 


inserted or removed. 


var status 7 psp.sysRadioGetMediaInOutStatus Q; 


This statement gets the current status of the Memory Stick Duo™ and whether it was 
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inserted or removed and sets it in the variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetMediaInOutStatus</title> 
</head> 
<body> 
<h1>sysRadioGetMedialnOutStatus</h1> 
<script language="JavaScript"> 
<les 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,2241,224,255, 255,255,255,255, 30,30,40,96, 1,2): 
} 
function test () { 
psp.sysRadioPrepareForScanDir ("/PSP/RADIOPLAYER") ; 
while ( true ) { 
var filename = psp.sysRadioScanDir (); 
if ( filename.length == 0 ) ( 
var status - psp.sysRadioGetMediaInOutStatus (); 
switch ( status ) ( 
case 0: 
psp.sysRadioDebugLog ("-- END --\n"); 
break; 
case 1: 
psp.sysRadioDebugLog 
("Memory Stick was ejected.\n"); 
break; 
case 2: 
psp.sysRadioDebugLog 
("Memory Stick Duo was re-connected.\n") ; 
break; 
} 
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" + filename + "\n"); 


break; 


} 


psp.sysRadioDebugLog ("file: 


} 
i, ==> 


</script> 


«button onclicks'test();'TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


sysRadioPrepareForScanDir, sysRadioScanDir 
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sysRadioPrepareForStrOperation 


Prepare for string search or string extraction processing 


Syntax 


psp. sysRadioPrepareForStrOperation ( str) 


Arguments 


str String to be processed 


Return Value 


Always 0. 


Description 


This extended method sets the string that is to be processed for string processing by 
methods such as sysRadioStrLength, sysRadioStrIndexOf, sysRadioStrSlice, and 
sysRadioStrOperationTerminate. 


The maximum length is 51199 bytes. 


Example 


psp.sysRadioPrepareForStrOperation ("HELLO"); 


This statement sets the string "HELLO" as the string to be processed by the 
sysRadioStrLength, sysRadioStrIndexOf, sysRadioStrSlice, and 


sysRadioStrOperationTerminate methods. 


Sample 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
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<title>sysRadioPrepareForStrOperation</title> 
</head> 
<body> 
<h1>sysRadioPrepareForStrOperation</h1> 
<script language="JavaScript"> 
<!-- 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255, 30,30,420,96. Le 2) å 
} 
function test () { 
var targetStr = "ABCDEFG: :HIJKLMN: :OPORSTU: : VWXYZ: :0123456789::"; 


var separator = "::"; 


// sysRadio's STRING METHOD 
psp.sysRadioPrepareForStrOperation (targetStr); 
var length = psp.sysRadioStrLength (); 
psp.sysRadioDebugLog ("\nlength: " + length + "\n"); 
var startPos = 0; 
while ( true ) { 
var index; 
index - psp.sysRadioStrIndexOf (separator, startPos) ; 
if ( index < 0 ) break; 
var slicedStr = psp.sysRadioStrSlice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 
} 


psp.sysRadioStrOperationTerminate (); 


// STANDARD STRING METHOD 
psp.sysRadioDebugLog ("\nlength: " + targetStr.length + "\n"); 
startPos = 0; 
while ( true ) { 
var index; 


index = targetStr.indexOf (Separator, startPos) ; 
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if ( index < 0) break: 


var slicedStr = targetStr.slice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 
} 

} 

P => 

</script> 

«button onclick-'test();'»TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioStrLength, sysRadioStrIndexOf, sysRadioStrSlice, sysRadioStrCharCodeAt, 


sysRadioStrOperationTerminate 
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sysRadioStrLength 


Return string length as value in terms of bytes 


Syntax 


result = psp. sysRadioStrLength () 


Arguments 


None. 


Return Value 


The string length (in bytes) is returned. 


Description 


This extended method returns the length of the string that was set by the 
sysRadioPrepareForStrOperation method. 
It performs processing that is almost equivalent to that of the JavaScript standard method 


length. The processing differs in that the return value is in bytes not characters. 


Example 
var result = psp.sysRadioStrLength 0: 
This statement sets the length of the string that was set by the 
sysRadioPrepareForStrOperation method in the variable result. 

Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioStrLength</title> 

OSCEI PSP™ Internet Radio Player Development Guide 


- 145 - 


</head> 
<body> 
<h1>sysRadioStrLength</h1> 


<script language="JavaScript"> 


Flen 
window.onload - function () ( setTimeout ('initProc ()', 500); j 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,221,224,255, 255,255,255,255, 30,30,40,96, 1. 213 
} 
function test () { 


var targetStr = "ABCDEFG: :HIJKLMN: :OPORSTU: : VWXYZ: :0123456789:: 


var separator = "::"; 


// sysRadio's STRING METHOD 
psp.sysRadioPrepareForStrOperation (targetStr); 
var length - psp.sysRadioStrLength (); 
psp.sysRadioDebugLog ("\nlength: " + length + "\n"); 
var startPos = 0; 
while ( true ) { 
var index; 
index - psp.sysRadioStrIndexOf (separator, startPos); 
if ( index < 0 ) break; 
var slicedStr = psp.sysRadioStrSlice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("slicedStr: " + slicedStr + "\n"); 
} 


psp.sysRadioStrOperationTerminate (); 


// STANDARD STRING METHOD 


psp.sysRadioDebugLog ("\nlength: " + targetStr.length + "\n"); 


startPos = 0; 
while ( true ) ( 
var index; 
index - targetStr.indexOf (separator, startPos); 


LE ( index < O0 ) break: 
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var slicedStr = targetStr.slice (startPos, index); 


startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 
} 
} 
[I ==> 
=/SCripc> 
«button onclick="test();'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Execution Result 


sysRadioStrLength 


window.onload = function () { setTimeout (‘initProc (sete 
function initProc () { | 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogT extStyle = 
(224224,224,255, 255,255,255,255, 30,30,40,96, 1,2); 
} 
function test () | 
var targetStr = "ABCDEFG::HIJKLMN::OPQRST LE E NES 
var separator - ":" LES TUf 


// SysRadio's STRING METHOD 


DSC aadinPrenareForstrÖneration 





See Also 


sysRadioPrepareForStrOperation, sysRadioStrIndexOf, sysRadioStrSlice, 
sysRadioStrCharCodeAt, sysRadioStrOperationTerminate 
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sysRadioStrindexOf 


Search for string pattern 


Syntax 

result — psp. sysRadioStrindexOf ( pattern, startPos ) 
Arguments 

pattern Search keyword string 

startPos Search starting position (units: bytes) 


Return Value 


The detected position (units: bytes) is returned. 


Description 


This extended method searches for the search string pattern pattern in the string that was 
set by the sysRadioPrepareForStrOperation method from a position that 1s startPos bytes 
from the beginning of the string towards the end and returns the matching location. 

It performs processing that 1s almost equivalent to that of the JavaScript standard method 
indexOf. The processing differs in that the units for specifying the position are in bytes not 
characters. 

Although it depends of the length of the string to be handled, this function is between 


several times to 10 times faster than the standard method. 


Example 
var result = psp.sysRadioStrLength ("::", 0 ); 
This statement searches for the pattern "::" from the beginning of the string that was set by 


the sysRadioPrepareForStrOperation method and sets the position that was found in the 


variable result. 
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<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioStrindexOf</title> 

</head> 

<body> 

<h1>sysRadioStrIindexOf</h1> 


<script language="JavaScript"> 


«e 
window.onload - function () ( setTimeout ('initProc ()', 500); j 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255,. 30,30,10;96, 1,2); 
} 
function test () { 


var targetStr = "ABCDEFG: :HIJKLMN: :OPORSTU: : VWXYZ: :0123456789::"; 


var separator PER 


// sysRadio's STRING METHOD 
psp.sysRadioPrepareForStrOperation (targetStr); 
var length = psp.sysRadioStrLength (); 
psp.sysRadioDebugLog ("\nlength: " + length + "\n"); 
var startPos = 0; 
while ( true ) { 
var index; 
index - psp.sysRadioStrIndexOf (separator, startPos); 
if ( index < 0 ) break; 
var slicedStr = psp.sysRadioStrSlice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 
} 


psp.sysRadioStrOperationTerminate (); 


// STANDARD STRING METHOD 


psp.sysRadioDebugLog ("\nlength: " + targetStr.length + "\n"); 
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startPos = 0: 
while ( true ) ( 


var index; 


index - targetStr.indexOf (separator, startPos); 
if ( index « 0 ) break; 
var slicedStr - targetStr.slice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 
} 

} 

jt => 

</SCript> 

<button onclick="test();'>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Execution Result 


sysRadioStrindexOf 
tep | 


window.onload = function () ( setTimeout ('initProc.( 
function initProc () | | 
psp.sysRadioSetDebugMode (1); 


psp.sysRadioSetDebugLogTextStyle . 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 


} 
function test () | 
var targetStr = "ABCDEFG::HIJKLMN::OPQRST te 
var separator - ":" SiicedStr-DPURSTU! 
: וד‎ d'à 


// sysRadio's STRING METHOD Tifa Te c . 


snp RadoPrenarek oc StrOneration (target-Tr!: 





See Also 


sysRadioPrepareForStrOperation, sysRadioStrLength, sysRadioStrSlice, 
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sysRadioStrCharCodeAt, sysRadioStrOperationTerminate 
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sysRadioStrSlice 


Extract substring 


syntax 
result = psp. sysRadioStrSlice ( startPos. endPos ) 
Arguments 
startPos Extraction starting position (bytes) 
endPos Extraction ending position (bytes) 


Return Value 


The extracted string 1s returned. 


Description 


This extended method returns the substring from startPos to endPos of the string that was 
set by the sysRadioPrepareForStrOperation method. 

It performs processing that is almost equivalent to that of the JavaScript standard method 
slice. The processing differs in that the units for specifying the positions are in bytes not 
characters. 

Although it depends of the length of the string to be handled, this function is between 


several times to 10 times faster than the standard method. 


Example 
var result = psp.sysRadioStrSlice (2, 4 ); 
This statement extracts the substring from the second byte to the fourth byte of the string 


that was set by the sysRadioPrepareForStrOperation method and sets it in the variable 


result. 
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<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


בו 
, 


) 


<title>sysRadioStrSlice</title> 
</head> 

<body> 
<h1>sysRadioStrSlice</h1> 


<script language="JavaScript"> 


«e 
window.onload - function () ( setTimeout ('initProc ()', 500); 
function initProc () { 

psp.sysRadioSetDebugMode (1); 

psp.sysRadioSetDebugLogTextStyle 

(224,224,224,255, 255,255,255,255,. 30,30,10;96, 1,2); 

} 
function test () { 


var targetStr = "ABCDEFG: :HIJKLMN: :OPORSTU: : VWXYZ: :0123456789:: 


var separator PER 


// sysRadio's STRING METHOD 
psp.sysRadioPrepareForStrOperation (targetStr); 
var length = psp.sysRadioStrLength (); 
psp.sysRadioDebugLog ("\nlength: " + length + "\n"); 
var startPos = 0; 
while ( true ) { 

var index; 

index - psp.sysRadioStrIndexOf (separator, startPos) ; 


if ( index < 0 ) break: 


var slicedStr = psp.sysRadioStrSlice (startPos, index); 


startPos = index + separator.length; 


psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 


} 


psp.sysRadioStrOperationTerminate (); 


// STANDARD STRING METHOD 


psp.sysRadioDebugLog ("\nlength: " + targetStr.length + "\n"); 
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startPos = 0: 
while ( true ) ( 


var index; 


index - targetStr.indexOf (separator, startPos); 
if ( index « 0 ) break; 
var slicedStr - targetStr.slice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 
} 

} 

jt => 

</SCript> 

«button onclick-'test(); '»TEST«/button- 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Execution Result 


sysRadioStrSlice 


window.onload = function () { setTimeout ('initProc,l fe 
function initProc () { | 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle z 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 
} 
function test () { 
var targetStr = "ABCDEFG::HIJKLMN::OPQRST EE EC 
var separator = "::"; OPOF 
: ךא‎ 


// SysRadio's STRING METHOD slicedStr © . 


as aadinPrenareForSstrÖOoeratinn itarsetstri. 


- 





See Also 


sysRadioPrepareForStrOperation, sysRadioStrLength, sysRadioStrIndexOf, 
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sysRadioStrCharCodeAt, sysRadioStrOperationTerminate 
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sysRadioStrCharCodeAt 


Get character code 


Syntax 


result = psp. sysRadioStrCharCodeAt (pos) 


Arguments 


pos Character code acquisition position (in bytes) 


Return Value 


Character code. 


Description 


This extended method returns the character code of the character specified by pos in the 
string that was set by the sysRadioPrepareForStrOperation method. 

It performs processing that is nearly equivalent to that of the JavaScript standard method 
charCodeAt. The processing differs in that the units for specifying the position are in bytes 
not characters. 


This method can be used with system software version 5.00 or later. 


Example 
var result = psp.sysRadioStrCharCodeAt (0 ): 
This statement finds the character code of the first character in the string that was set by 
the sysRadioPrepareForStrOperation method and sets it in the variable result. 
Sample 
<html><head> 
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«meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioStrCharCodeAt</title> 
</head> 
<body> 
<h1>sysRadioStrSlice</h1> 
<script language="JavaScript"> 
«e 
window.onload = function () ( setTimeout ('initProc ()', 500); } 
function initProc CH I 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(22402245, 220, 255... 255. 295,25594255, 20-3020000 1, E 
) 
function test () + 
var targetStr = "ABCDEFG"; 


var pos = 5: 


// sysRadio's STRING METHOD 
psp.sysRadioPrepareForStrOperation (targetStr); 

var length = psp.sysRadioStrLength (); 
psp.sysRadioDebugLog ("\nlength: " + length + "\n"); 
var code = psp.sysRadioStrCharCodeAt (pos) ; 
psp.sysRadioDebugLog ("code: " + code + "\n"); 


psp.sysRadioStrOperationTerminate (); 


// STANDARD STRING METHOD 
psp.sysRadioDebugLog ("\nlength: " + targetStr.length + "\n"); 
var code = targetStr.charCodeAt (pos); 
psp.sysRadioDebugLog ("code: " + code + "\n"); 
} 
Ji ==> 
</script> 
«button onclick-'test();'»TEST«/button» 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 
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See Also 


sysRadioCapabilityCheck, sysRadioPrepareForStrOperation, sysRadioStrLength, 
sysRadioStrIndexOf, sysRadioStrSlice, sysRadioStrOperationTerminate 
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sysRadioStrOperationTerminate 


Terminate string search and extraction processing 


Syntax 


psp. sysRadioStrOperationTerminate () 


Arguments 


None. 


Return Value 


Always 0. 


Description 


This extended method terminates the string processing that was started by the 
sysRadioPrepareForStrOperation method. This method call releases resources that had 
been internally allocated in the PSPT" [Internet radio system by the 
sysRadioPrepareForStrOperation method. 

The sysRadioPrepareForStrOperation method call and sysRadioStrOperationTerminate 


method call form a pair, and these method calls cannot appear in a nested structure. 


Example 


psp.sysRadioStrOperationTerminate 0; 


This statement terminates string search and extraction processing. 


Sample 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
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<title>sysRadioStrOperationTerminate</title> 
</head> 
<body> 
<h1>sysRadioStrOperationTerminate</h1> 
<script language="JavaScript"> 
eT 
window.onload = function () ( setTimeout ('initProc ()', 500); } 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255, 30,30,420,96. Le 2)3 
} 
function test () { 
var targetStr = "ABCDEFG: :HIJKLMN: :OPORSTU: : VWXYZ: :0123456789::"; 


var separator = "::"; 


// sysRadio's STRING METHOD 
psp.sysRadioPrepareForStrOperation (targetStr); 
var length = psp.sysRadioStrLength (); 
psp.sysRadioDebugLog ("\nlength: " + length + "\n"); 
var startPos = 0; 
while ( true ) { 
var index; 
index - psp.sysRadioStrIndexOf (separator, startPos) ; 
if ( index < 0 ) break; 
var slicedStr = psp.sysRadioStrSlice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 


} 


psp.sysRadioStrOperationTerminate (); 


// STANDARD STRING METHOD 
psp.sysRadioDebugLog ("\nlength: " + targetStr.length + "\n"); 
startPos = 0; 
while ( true ) { 
var index; 


index = targetStr.indexOf (Separator, startPos) ; 
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if ( index < 0) break: 


var slicedStr = targetStr.slice (startPos, index); 
startPos = index + separator.length; 
psp.sysRadioDebugLog ("SlicedStr: " + slicedStr + "\n"); 
} 

} 

P => 

</script> 

«button onclick-'test();'»TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioPrepareForStrOperation, sysRadioStrLength, sysRadioStrIndexOf, 
sysRadioStrSlice, sysRadioStrCharCodeAt 


OSCEI PSP™ Internet Radio Player Development Guide 


- 161 - 


sysRadioCharacterEntityConvert 


Convert characters that include a character entity to an actual UTF-8-encoded string 


Syntax 


result = psp. sysRadioCharacterEntityConvert ( str) 


Arguments 


str String to be processed 


Return Value 


The converted string is returned. 


Description 


This extended method converts a string that represents an entity to an actual string. 


The maximum length of str is 511 bytes. 


Example 
var result = psp.sysRadioCharacterEntityConvert ("&#65;&nbsp;&#x42;"); 
This statement converts the entity representation string "&#65;&nbsp;&#x42;" to the string 
of actual characters "A B." 
Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioCharacterEntityConvert</title> 
</head> 
<body> 
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<h1>sysRadioCharacterEntityConvert</h1> 
<script language="JavaScript"> 
ml ee 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(226,220 228,290) 2:55, 299,299.4]895 030200208, 12 2) 
) 
function test () + 
var str = "&#65;&nbsp; &#x42;"; 
psp.sysRadioDebugLog ("Str=" + str + "\n"); 
var result = psp.sysRadioCharacterEntityConvert (str); 
psp.sysRadioDebugLog ("result-" + result + "\n"); 
} 
Eg ==> 
ו‎ 
<button onclick='test();'>TEST</button> 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Execution Result 


sysRadioCharacterEntityConvert 


eS ה‎ 
window.onload - function () | setTimeout ('initProc ()', 500); } 
function initProc () 1 

psp.sysHadioSetDebugMode (1); 

psp.sysRadioSetDebugLogT extStyle 

(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2); 

} 
function test () | 

var str — "8465: 8nbsp:8#x42:" 

psp.sysHadioDebugL og ("str-" «4 str « ^n"); 

var result - psp.sysRadioCharacterEnt 

psp.sysHadioDebugL og ("result-" « result « ^n"); 
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See Also 


None. 
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sysRadioCharacterCodeConvert 


Convert UTF-8 string to CP932 or CP949 string 


Syntax 


result = psp. sysRadioCharacterCodeConvert ( charCodeConvertOption, str ) 


Arguments 


charCodeConvertOption | Identifier for specifying character code conversion 

1: Convert string specified by str to SJIS (CP932). 

2: Convert string specified by str to EUC-KR (CP949). 
str UTF'-8 string to be converted 


Return Value 


Converted string. 


Description 


This extended method converts a UTF-8 string to an SJIS (CP932) or EUC-KR (CP949) 
string. 

The converted string is represented using %xx notation (where xx is a hexadecimal 
number). 

The maximum string length after conversion is 765 bytes. 


This method can be used with system software version 5.00 or later. 


Example 


var result_j = psp.sysRadioCharacterCodeConvert (1, "= Avila 5 lk"); // charset=utf-8 
var result k 7 psp.sysRadioCharacterCodeConvert (2, "HI 3) 2”): // charset=utf-8 


The first statement converts the UTF-8 string “= /v/(z 5(X" to SJIS (CP932) and returns 


"^968296b1968296f1968296c9968296bf968296cd" 1n the variable result j. 
Similarly, the second statement converts "9HF3e|4|8" to EUC-KR (CP949) and returns 
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06% 016647 גנ‎ +6 variable result k. 


Sample 
<html><head> 
«meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioCharacterCodeConvert</title> 
</head> 
<body> 
<h1>sysRadioCharacterEntityConvert</h1> 
<script language="JavaScript"> 
<!-- 
window.onload = function () { setTimeout ('initProc ()', 500); } 
function initProc )( { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,2241,224,255, 255,290,200 7200; 30,30,40,96, 1,2): 
} 
function test () { 
var result; 
year gSbe mcg 
result - psp.sysRadioCharacterCodeConvert (1, jStr); 
psp.sysRadioDebugLog (jStr + "-<" + result + "\n"); 
var kStr = “Ordo”, 
result = psp.sysRadioCharacterCodeConvert (2, kStr): 
psp.sysRadioDebugLog (kStr + "->" + result + "\n"); 
} 
[y we 
</script> 
«button onclick='test()/'>TEST<x/button> 
<object name="psp" type="application/x-psp-extplugin"></object> 
</body></html> 
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Execution Result 


sysRadioCharacterCodeConvert 


window.onload - function () | setTimeout ('initProc ()', 500); } 
function initProc () 1 

psp.sysRadiosetDebugMode (1); 

psp.sysRadiosetDebugLogT extStyle 

(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2): 

} 
function test () | 

var result; 

var jStr = "TA IIS I"; 

result = psp a7 id24»6Hg96D 196Bz96f I 62 JC 96H26 

psp.sysRadioLjst: Vee des ech ve rd גי‎ ie 


ar kStr = "O AoH g" 





See Also 


sysRadioCapabilityCheck 
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sysRadioGetAnalogStickXValue 


Get analog stick's X value 


Syntax 


result = psp. sysRadioGetAnalogStickXValue () 


Arguments 


None. 


Return Value 


An integer value in the range -128 Sresult S127 is returned. 


Description 


This extended method returns an integer value indicating the coordinate value in the left or 
right direction of the analog stick, which was operated simultaneously with the PSP™ 


system's |] button. 





Example 
var result = psp.sysRadioGetAnalogStickXValue 0; 
This statement gets the analog stick's coordinate value in the left or right direction. 
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Sample 


<html><head> 
«meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioDebugLog</title> 
</head> 
<body> 
<h1>sysRadioDebugLog</h1> 
<script language="JavaScript"> 
mes 
window.onload = function () ( setTimeout ('initProc ()', 500); } 
Var tid = U} 
Function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,290; 2007200; 30,30,40,96, 1,2): 
tid = setinterval ('intervalProc ()*, 500); 
) 
function intervalProc () { 
var result = psp.sysRadioGetAnalogStickXValue (); 
psp.sysRadioDebugLog ("Analog stick's X Value =" 
+ result + "\n"); 
} 
sie 
0 
Please operate [ll] button and [Analog Stick]... 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioGetAnalogStickY Value 
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sysRadioGetAnalogStickYValue 


Get analog stick's Y value 


Syntax 


result = psp. sysRadioGetAnalogStickYValue () 


Arguments 


None. 


Return Value 


An integer value in the range -128 S result S127 is returned. 


Description 


This extended method returns an integer value indicating the coordinate value in the up or 
down direction of the analog stick, which was operated simultaneously with the PSP™ 


system's |] button. 





Example 


var result = psp.sysRadioGetAnalogStickYValue 0; 


OSCEI PSP™ Internet Radio Player Development Guide 


- 170 - 


This statement gets the analog stick's coordinate value in the up or down direction. 


<html><head> 
«meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioDebugLog</title> 
</head> 
<body> 
<h1>sysRadioDebugLog</h1> 
<script language="JavaScript"> 
<!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); } 
var tid = 0; 
function anitPbroc 6( 4 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224.221,224,255, 255,255/255,2555, 30/30/60 206% 1, 2)5 
tid e setlnterval ('intervalProc ()', 500); 
} 
function intervalProc () { 
var result - psp.sysRadioGetAnalogStickYValue (); 
psp.sysRadioDebugLog ("Analog stick's Y Value =" 
+ result + "\n"); 
} 
f oe 
eJ BDPIDE 
Please operate [LJ] button and [Analog Stick]... 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


sysRadioGetAnalogStickXValue 
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Sample 


See Also 


OSCEI 


sysRadioGetAnalogStickAngleValue 


Get the analog stick's angle value 








Syntax 





result = psp. sysRadioGetAnalogStickAngleValue () 


Arguments 





None. 


Return Value 


An integer value in the range -2048 x Sresult 220487 is returned. 


Description 


This extended method returns the angle relative to the horizon of the analog stick, which 


was operated simultaneously with the PSP™ system's |] button. 





Example 
var result = psp.sysRadioGetAnalogStickAngleValue 0; 
This statement gets the analog stick's angle. 
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Sample 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioDebugLog</title> 

</head> 

<body> 

<h1>sysRadioDebugLog</h1> 


<script language="JavaScript"> 


«e 
window.onload = function () { setTimeout ('initProc ()', 500); } 
var tid = 0; 
function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224 4224 0.235 250,200 20,200 90,500,740, 96; LP 
tid = setInterval ('intervalProc ()', 500); 
} 
function intervalProc () { 
var result = psp.sysRadioGetAnalogStickAngleValue (); 
psp.sysRadioDebugLog ("Analog stick's AngleValue =" 
+ result + "\n"); 
} 
ff ==> 
= ד‎ KE 


Please operate [ll] button and [Analog Stick]... 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></btnl> 


See Also 


sysRadioGetAnalogStickRadiusV alue 
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sysRadioGetAnalogStickRadiusValue 


Get position from center of analog stick 


Syntax 


result = psp. sysRadioGetAnalogStickRadiusValue () 


Arguments 


None. 


Return Value 


An integer value in the range OE result £4 (1282 + 1282) is returned. 


However, result=/ (1282 + 1282) is not valid for the PSP™ system. 


Description 


This extended method returns the size of the offset from the center of the analog stick, 
which was operated simultaneously with the PSP™ system's LI button. 
It returns a value equivalent to: 
Math.floor (Math.sqrt (Math.pow (psp.sysRadioGetAnalogStickXValue (), 2) 
+ Math.power (psp.sysRadioGetAnalogStickYValue (), 2))). 
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Example 


var result = psp.sysRadioGetAnalogStickRadiusValue 0; 


This statement gets the position from the center of the analog stick and sets it in the 


variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioDebugLog</title> 
</head> 
<body> 
<h1>sysRadioDebugLog</h1> 
«script languages"JavaScript"- 
epe 
window.onload = function () { setTimeout ('initProc ()', 500); J 
var tid = 0; 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224.221, 242055, LO AA DI 225, 30/30 0206 1 ל[‎ 
tid > setInterval ('intervalProc ()', 500); 
) 
function intervalProc () + 
var result - psp.sysRadioGetAnalogStickRadiusValue (); 
psp.sysRadioDebugLog ("Analog stick's RadiusValue =" 
+ result + "\n"); 
} 
]] we 
e/scriptse 
Please operate [l]] button and [Analog Stick]... 
<object name="psp" type="application/x-psp-extplugin"></object> 
</body></html> 
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See Also 


sysRadioGetAnalogStickAngleValue 
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Set debug mode 


sysRadioSetDebugMode 


Syntax 


result = psp. sysRadioSetDebugMode ( flag ) 


Arguments 


flag Debug mode setting. 
0: Debug mode OFF. 
1: Debug mode ON. 


Return Value 


Always 0. 


Description 


This extended method turns debug mode on or off. 


When debug mode is on, text can be displayed on the "debug log console," which is described 


in the Description section of the sysRadioSetDebugLogTextStyle method, or a screenshot 


file can be created by simultaneously pressing the PSP™ system's START and R buttons. 


Example 
psp.sysRadioSetDebugMode (1); 
This statement turns debug mode on. 
Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioDebugLog</title> 
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(pry 500); ) 


50,30,40,96, 1, 2; 


1000); 


type="application/x-psp-extplugin"></object> 


() { setTimeout ('initProc 


255,255,255,255, 


</head> 

<body> 
<h1>sysRadioDebugLog</h1> 
<script language="JavaScript"> 
<!-- 

window.onload = function 
function initProc )( + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 


(224,224,224,255, 


tid = setInterval ('intervalProc ()', 
) 
var Cid = 0; 
function intervalProc )( + 
psp.sysRadioDebugLog ("HELLO\n") ; 


} 

var state = true; 
function test () { 
state = !state; 


psp.sysRadioSetDebugMode ( state ? I 


} 

pg ==> 

</script> 

<button onelick="test|) i; '>TESTA button» 
<object name="psp" 


</body></html> 


sysRadioSetDebugLogTextStyle, sysRadioDebugLog, sysRadioClearDebugLog, 


sysRadioCaptureScreenShot 
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See Also 


OSCEI 


sysRadioDebugLog 


Display string on debug log console 


result = psp. sysRadioDebugLog ( str ) 


syntax 


Arguments 


str String to be displayed 


Return Value 


Always 0. 


Description 


This extended method enables the arbitrary UTF-8-encoded string str to be displayed on 
the "debug log console," which 1s described 1n the Description section of the 
sysRadioSetDebugLogTextStyle method. 

Å line feed is automatically inserted when the number of characters reaches 37. Note that 
the line feed is controlled by the number of characters, not the width of the string. Å line 
feed can also be forcibly inserted by specifying "\n." The screen is automatically scrolled by 


a line feed. The screen cannot be scrolled in the reverse direction. 


The debug log display function is more convenient to use than the standard JavaScript 
alert method if you want to continuously watch the values of certain variables. 
sysRadioDebugLog and alert should be used properly for different purposes during 
Javascript debugging. 

The display contents of the debug log will be corrupted and the console screen erased when 
the PSP™ system's HOME button is pressed or the on-screen keyboard (OSK) or a dialog 
such as the network configuration screen is displayed. 

Also, the scroll range or number of lines cannot be specified. Since this function has these 


various limitations, 1t has limited use for debugging purposes, and you should avoid 
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actively using it as part of the GUI of the Internet radio player (for such purposes as 


displaying the broadcast station name or song name). 


psp.sysRadioDebugLog ("HELLO\n"); 


This statement displays "HELLO" on the debug log console. 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


) 


<title>sysRadioDebugLog</title> 
</head> 

<body> 
<h1>sysRadioDebugLog</h1> 
<script language="JavaScript"> 


ele 


window.onload - function () ( setTimeout ('initProc ()', 500); 


function initProc () { 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2): 
) 
function test () ( 
psp.sysRadioDebugLog ("HELLO\n") ; 
} 
fy 2 
</script> 


<button onclick='"tesťt(); '>TEST<x/button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 
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Example 


Sample 


©SCEI 


Execution Result 


sysRadioDebugLog 


window.onload - function () | setTimeout ('initProc ()', 500); } 
function initProc () I 

psp.sysHadioSetDebugMode (1); 

psp.sysHadioSetDebugL ogTextStyle 

(224,224,224,255, 255,255,255,255, 30,30,40,96, 1, 2): 

} 
function test () | 

psp.sysRadioDebugL og ("HELL On"); 
} 





See Also 


sysRadioSetDebugLogTextStyle, sysRadioClearDebugLog, sysRadioSetDebugMode 
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sysRadioSetDebugLogTextStyle 


Set debug log console's text style 


Syntax 


result = psp. sysRadioSetDebugLogTextStyle 
( colorFOr, colorF0g, colorF0b, colorF0a 
|, colorF1r, colorF1g, colorF1b, colorF1a 
|, colorBr, colorBg, colorBb, colorBa 
[, slyle, 
[align 111) 


Arguments 
colorFOr R, G, B, and A values of character color 0. 
colorF0g These are integer values in the range OX colorFÜr, colorF0g, colorFOb, 
colorF0b colorF0a S255. 
colorF0a 
colorF1r R, G, B, and A values of character color 1. (optional) 
colorF1g These are integer values in the range 0ScolorF1r, colorF1g, colorF1b, 
colorF1b colorF1a S 255. 
colorF1a 
colorBr R, G, B, and A values of character background color 1. (optional) 
colorBg These are integer values in the range OX colorBr, colorBg, colorBb, 
colorBb colorBa € 255. 
colorBa 
slyle Character style specification. (optional) 
0: Regular character. 
1: Bold character (however, only letters and numbers). 
align Alignment specification. (optional) 
0: Left justified 
1: Centered 


2: Right justified 


Return Value 


Always 0. 
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Description 


This extended method specifies the text style that will be used for displaying the debug log 
console. 

The specified text style is not just reflected in text that is output by the sysRadioDebugLog 
method after the sysRadioSetDebugLogTextStyle method was called, but all text that has 
already been displayed 1s also switched to the style specified by the 
sysRadioSetDebugLogTextStyle method. 


The style cannot be changed for each display line of the debug log console. All lines are set 
to the same style. 


The character shadow display cannot be turned off. 


The following color attributes can be set for text that 1s displayed on the debug log console. 
colorF0 (colorFOr, colorF0g, colorF0b, and colorF0a) specifies the color of the upper end of the 
characters, colorF1 (colorF1r, colorF1g, colorF1b, and colorF1a) specifies the color of the 
lower end of the characters, and colorB (colorBr, colorBg, colorBb, and colorBa) specifies the 
background color. 

If colorF1 is omitted, the characters are drawn monochromatically using colorF0. 


If colorB is omitted, no character background is drawn. 


colorF 1 





colorB 


slyle specifies the character thickness. 

align specifies line alignment. 

If the Internet radio player and debug log console displays overlap so that the debug log 
console is illegible, this method should be used to change the style. 


The debug log console has the following structure. 


The debug log console is displayed so that it is superimposed on top of the browser screen. 
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Up to 37 characters are displayed per line and up to 16 lines per screen. If the maximum 
number of characters per line or lines per screen is exceeded, a line feed is automatically 
inserted or the screen 1s automatically scrolled. When the screen 1s scrolled, text that 


disappears from the screen 1s eliminated and cannot be scrolled back. 





Internet radio player 
(Internet browser screen) 
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When the PSP™ system's HOME button is pressed to display the XMB™ or when a dialog 
is displayed (such as by clicking a text input form to display the on-screen keyboard (OSK)), 
the debug log console display will be erased. 


Example 


psp.sysRadioSetDebugLogTextStyle (255,255,255,255, 255,255,255,255, 0,0,0,255, 0, 2); 


This statement sets the text style to "white text body, black background, regular type 


characters, and right justified." 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioDebugLog</title> 
</head> 
<body> 
<h1>sysRadioDebugLog</h1> 
<script language="JavaScript"> 
<!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); j 
var tid = 0; 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
tid - setInterval ('intervalProc ()', 1000); 
} 
function intervalProc () + 
psp.sysRadioDebugLog ("HELLO\n") ; 
} 
function testA () { 
psp.sysRadioSetDebugLogTextStyle 
(224,160,160,255, 255,192,192,255, 40,30,30,96, 1, 0); 
) 
function testB () ( 
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psp.sysRadioSetDebugLogTextStyle 
(160,224, 150,2955,. 192,255,192,255, 30,40,30,96, 1, 1): 
j 
function testC () ( 
psp.sysRadioSetDebugLogTextStyle 
[(160,160,224,255, 192,.192,2557;2594 30,30,40,95, X; 273 
) 
function testD () ( 
psp.sysRadioSetDebugLogTextStyle 
(255,255,255,255, 2597235723972397 0,0;0,255, Uy, DS 


} 


M 

</seript> 

<button onclick='testA();'>TEST A</button><br> 
<button onclick='testB();'>TEST B</button><br> 
«button onclick-'testC():'»TEST C«/button»«btr- 
«button onclicks-s'testD();'»TEST D</button- 


«object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Execution Result 


sysRadioSetDebugLogTextStyle 


s.onload — function () { setTimeout ('initProc ()', 500); | 


alasan initProc () | 
aansissysRadioSetDebugMode (1); 
alae setinterval ('intervalProc ()', 1000); 


D intervalProc () 1 


- 2 
siis ו‎ 
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sysRadioSetDebugLogTextStyle 


window.onload = function () | set&E SS ('initProc ()', 500); } 
var tid = Q; HELLO) 
function initProc () I 
psp.sysRadioSetDebugMode (alzi* Ex. 
tid = setinterval ('intervalProca] s £w0); 
| 


window.onload - function () | setTimeout ('initProc ()', 500); } 
var tid = Q; 
function initProc () 1 
psp.sysRadioSetDebugMode (1); 
tid = setinterval (‘intervalProc ()', 1000); 
} 
function intervalProc () 1 





See Also 


sysRadioDebugLog, sysRadioClearDebugLog, sysRadioSetDebugMode 
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sysRadioClearDebugLog 


Clear strings displayed on debug log console 


Syntax 


result = psp. sysRadioClearDebugLog () 


Arguments 


None. 


Return Value 


Always 0. 


Description 


This extended method clears all strings that are displayed on the debug log console. 


Example 


psp.sysRadioClearDebugLog 0; 


This statement clears the strings that are displayed on the debug log console. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioClearDebugLog</title> 
</head> 
<body> 
<h1>sysRadioClearDebugLog</h1> 
<script language="JavaScript"> 
©SCEI PSP™ Internet Radio Player Development Guide 


- 188 - 


<!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); j 
vår tid = 0; 
function initProc () + 
psp.sysRadioSetDebugMode (1); 
psp.sysRadioSetDebugLogTextStyle 
(224,224,-224,255, 255,255,2555255, 30,30,40,96. 10 2), 
tid = setInterval ('intervalProc ()', 1000); 
} 
function intervalProc () + 
psp.sysRadioDebugLog ("HELLO\n") ; 
} 
function test () { 


psp.sysRadioClearDebugLog (); 


) 

pg wee 

עס 

<button onclick="test();'>TEST</button> 

<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioSetDebugLogTextStyle, sysRadioDebugLog, sysRadioSetDebugMode 
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sysRadioGetPlayerCoreVersioninfo 


Get PSP™ Internet radio player system core version information 


syntax 


result = psp. sysRadioGetPlayerCoreVersionInfo () 


Arguments 


None. 


Return Value 


The PSP™ Internet radio player system core version information string is returned. 


Description 


This extended method enables you to get the version number of the Internet radio 


processing system of the PSP'M system software. 


By saving the information that 1s returned by the sysRadioGetPlayerCoreVersionInfo 
method in a cookie, you can check the validity of the cookie information (by matching the 
cookie information and the PSP™ Internet radio player system core version) when the 


Internet radio player is started up. 


A PSP-1000 series system returns the following string. 
"PSP-1000:RadioPlayerCore_5.0.0" 

PSP-2000 series and PSP-3000 series systems return the following string. 
"PSP-2000:RadioPlayerCore_5.0.0" 


Example 


var result = psp.sysRadioGetPlayerCoreVersionInfo Q; 
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This statement gets version information and sets it in the variable result. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetPlayerCoreVersionInfo</title> 
</head> 
<body> 
<hl>sysRadioGetPlayerCoreVersionInfo</hl> 
<script language="JavaScript"> 
<!-- 
function test () { 
var result = psp.sysRadioGetPlayerCoreVersionInfo (); 
alert ("result=" + result); 
} 
er 
>, 070% 
«button onclicks'test();' '»TEST«/button» 
<object name="psp" type="application/x-psp-extplugin"></object> 
</body></html> 
See Also 
None 
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sysRadioCapabilityCheck 


Get support information related to a specific function 


Syntax 


result = psp. sysRadioCapabilityCheck ( id ) 


Arguments 


id Inquiry item ID 


Return Value 


id Return Value 


OE or 





Description 


Currently, the only inquiries that are supported concern the availability of AAC+ handling 
and whether or not the sysRadioSleep, sysRadioGetLeftAudioAverageLevel, 
sysRadioGetRightAudioAverageLevel, sysRadioStrCharCodeAt, 
sysRadioCharacterCodeConvert, and sysRadioGetSystemStatus methods can be used. 

If 0 is specified for the argument, 1 is returned when an AAC+ stream can be played and 0 
is returned when it cannot be played. 

If 1 is specified for the argument, 1 is returned when the sysRadioSleep method can be used 
and 0 is returned when it cannot be used. The sysRadioSleep method can be used with 
system software version 3.93 or later. 

If 2 is specified for the argument, 1 is returned when the 
sysRadioGetLeftAudioAverageLevel and sysRadioGetRightAudioAverageLevel methods 


can be used and 0 is returned when they cannot be used. The 
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sysRadioGetLeftAudioAverageLevel and sysRadioGetRightAudioAverageLevel methods 
can be used with system software version 5.00 or later. 

If 3 is specified for the argument, 1 is returned when the sysRadioStrCharCodeAt method 
can be used and 0 is returned when it cannot be used. The sysRadioStrCharCodeAt method 
can be used with system software version 5.00 or later. 

If 4 is specified for the argument, 1 is returned when the sysRadioCharacterCodeConvert 
method can be used and 0 is returned when 1t cannot be used. The 
sysRadioCharacterCodeConvert method can be used with system software version 5.00 or 
later. 

If 5 is specified for the argument, 1 is returned when the sysRadioGetSystemStatus method 
can be used and 0 is returned when it cannot be used. The sysRadioGetSystemStatus 


method can be used with system software version 5.00 or later. 


id Inquiry Contents 


FO 1 Can AAC+ stream be played? 
Can the sysRadioSleep method be used? 


sysRadioGetRightAudioAverageLevel methods be used? 





Can the sysRadioGetSystemStatus method be used? 


var result = psp.sysRadioCapabilityCheck (0); 


This statement inquires whether an AAC+ stream can be played. 


<html><head> 

<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetPlayerCoreVersionInfo</title> 

</head> 

<body> 

<hl>sysRadioGetPlayerCoreVersionInfo</h1l> 

<script language="JavaScript"> 


tag 
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Example 


Sample 


OSCEI 


function test (n) { 
var result - psp.sysRadioCapabilityCheck (0); 
alert ("result=" + result); 
} 
jf ==> 
0ם/>‎ 16% 
“button onclick="test (0) ;"sTEST(0)</button=<br> 
<button onclick="'test (1): 'sTEST(1)</button><br> 
<bution onclick="test (2) ="STEST (2)</button><br> 
<button onclick="test(3)7"*STEST(3)</button><br> 
«button oneliek="test(4): '>TEST(4)</button><br> 
ebutton Mmolick="test (5); ">TESTIS |< button» <br> 
«Dutton oncliocks'test[(5); »2TEST(B)«7/button»ebr- 
<object name="psp" type="application/x-psp-extplugin"></object> 


«/body»«/html» 


See Also 


sysRadioSleep, sysRadioGetLeftAudioAverageLevel, sysRadioGetRightAudioAverageLevel, 
sysRadioStrCharCodeAt, sysRadioCharacterCodeConvert 
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sysRadioGetStartButtonToggleStatus 


Get PSP!" system's START button toggle status 


Syntax 


result = psp. sysRadioGetStartButtonToggleStatus () 


Arguments 


None. 


Return Value 


0 Status value when the PSP™ system's START button is considered to 
be a toggle switch 1s 0. 
1 Status value when the PSP™ system's START button is considered to 


be a toggle switch is 1. 


Description 


This extended method considers the PSP™ system's START button to operate as a toggle 
switch and returns its toggle status. 


The return value changes each time the START button 1s pressed. 





The PSP™ system's START button is not directly related to any Internet radio player 


function. 
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HINT 
One of the Internet radio players provided by SCE detects this toggle value and 


controls sound muting in the JavaScript code. 


Example 


var result = psp.sysRadioGetStartButtonToggleStatus Q; 


This statement gets the toggle status of the PSP™ system's START button. 


Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioGetStartButtonToggleStatus</title> 
</head> 
<body> 
<h1>sysRadioGetStartButtonToggleStatus</h1> 
<script language="JavaScript"> 
«1-- 
function test () ( 
var result - psp.sysRadioGetStartButtonToggleStatus (); 
alert ("[START] button's toggle state-" + result); 
) 
jf ==> 
</BCript> 
<button onclidk="test|): '>TEST< button» 
<object name="psp" type="application/x-psp-extplugin"></object> 
</body></html> 
See Also 
None. 
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sysRadioBackLightAlwaysOn 


Control backlight 


Syntax 


result = psp. sysRadioBackLightAlwaysOn ( flag ) 


Arguments 


flag When 1 is specified, the Internet radio player is in a state in which the 
backlight is always on, and when 0 is specified, this state is canceled. 


Return Value 


Always 0. 


Description 


Executing sysRadioBackLightAlwaysOn (1) when the AC adapter is connected causes the 
backlight to always be on. 


Use this as necessary from a production standpoint such as to always display the GUI. 


If sysRadioBackLightAlwaysOn (0) is executed, the backlight automatically goes off after 
the interval specified in the system configuration elapses (note that it does not go off 


immediately). 


Also, during battery operation (when the AC adapter is not in use), the Internet radio 
player will not be set to a state in which the backlight is always on even if 
psp.sysRadioBackLightAlwaysOn (1) is executed. (It will behave as specified in the system 


configuration.) 


This extended method does not affect the operation of the PSP™ system's display button. 
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psp.sysRadioBackLightAlwaysOn (1); 


This statement sets a state in which the backlight 1s always on. 


content="text/html: charset=utf-8"> 


<html><head> 


<meta http-equiv="content-type" 


<title>sysRadioBackLightAlwaysOn</title> 


</head> 


<body> 


<h1>sysRadioBackLightAlwaysOn</h1> 


<script language="JavaScript"> 


== 
var state = false; 
function test () + 
state = !state; 
if ( state ) { 
psp.sysRadioBackLightAlwaysOn (1); 
alert 
("Backlight is always ON if you are using AC adapter."); 
} 
else { 
psp.sysRadioBackLightAlwaysOn (0); 
alert ("Backlight will turn OFF in a few minutes."); 
} 
} 
fi =y 
</script> 
«button onclicks'test();'»TEST«/button» 


<object name="psp" type="application/x-psp-extplugin"></object> 
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</body></btml> 


Example 


Sample 


OSCEI 


See Also 


None. 
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sysRadioBusyindicator 


Control busy indicator display 


Syntax 
psp. sysRadioBusylndicator ( flag ) 
Arguments 
flag If 1 is specified, the busy indicator appears, and if 0 is specified, it is 
hidden. 


Return Value 


Always 0. 


Description 


This extended method controls the busy indicator display at the bottom right side of the 
screen. 
If the argument is set to 1, the busy indicator of the following figure (execution result) is 


displayed at the bottom right side of the screen. 


Example 
psp.sysRadioBusyIndicator (1); 
This statement displays the busy indicator. 
Sample 
<html><head> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioBusyIndicator</title> 
</head> 
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<body> 
<h1>sysRadioBusyIndicator</h1> 
«script languages"JavaSoript"- 


lm 


var state - false; 
function test () ( 
state = !state; 


psp.sysRadioBusyIndicator ( state ? 1 : 0 ); 
} 
gg ==> 
</sSoript> 
«button onclicks'test();'^TEST«/button» 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


Execution Result 


sysHadioBusylndicator 


TEST 


var state - false; 
function test () | 
state - !state; 
psp.sysRadioBusyindicator ( state ? 1:0); 





Busy icon 


See Also 


None. 
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sysRadioCaptureScreenShot 


Capture screenshot 


Syntax 


result = psp. sysRadioCaptureScreenShot () 


Arguments 


None. 


Return Value 


0 Processing was successful 
1 Error 


Description 


This extended method saves the display state of the screen (screenshot) as a BMP-format 
image file with a filename of the form "RP-yyyymmdd-hhmmss" in the 
"/PICTURE/RADIOPLAYER SCREENSHOT" directory on a Memory Stick Duo™. 


The date and time used for the filename are local time. 






Memory Stick Duo™ PICTURE  RADIOPLAYER RP-20071212-141034.BMP 


SCREENSHOT 


| RP-20071212-141625.BMP 


Å screenshot file can also be created in debug mode (for details, see 
sysRadioSetDebugMode) by simultaneously pressing the PSP™ system's START and R 


buttons. 
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At the instant that the file is created, the same sound effect is produced as when the 


sysRadioPlay EffectSound method 1s executed. 


If there is no free space in the JavaScript extended method processing queue, -1 is returned. 
At this time, the processing request is ignored (discarded). As long as method calls of types 
that are queued are not continuously issued (such as in an endless loop), this state does not 


normally occur. 


The following methods are types that are queued. 


Method Names of Types That Overview 
are Queued 


sysRadioPlayStream Starts playback by specifying URL of audio data stream 
sysRadioPlayPls Starts playback by specifying URL of PLS file 


sysRadioPlayM3u Starts playback by specifying URL of M3U file 
sysRadioPrepareForHttpGet Prepares for performing HTTP GET for specified URL 
sysRadioCaptureScreenShot 





Example 


result = psp.sysRadioCaptureScreenShot (); 


This statement captures a screenshot. 


Sample 


<html><head> 
«meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>sysRadioCaptureScreenShot</title> 
</head> 
<body> 
<h1>sysRadioCaptureScreenShot</h1> 
<script language="JavaScript"> 
>!-- 
window.onload = function () ( setTimeout ('initProc ()', 500); } 
function initProc () I 
psp.sysRadioSetDebugMode (1); 
) 


function test () I 
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psp.sysRadioCaptureScreenShot (); 


// ==> 
</script> 


<button onclick='test();'>TEST</button> or [START]+[R] <br> 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioSetDebugMode, sysRadioPlay EffectSound, 
sysRadioPlayStream, sysRadioPlayPls, sysRadioPlayM3u, sysRadioPrepareForHttpGet 
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sysRadioSleep 


set PSP™ system sleep mode 


syntax 


psp. sysRadioSleep () 


Arguments 


None 


Return Value 


Always 0. 


Description 


The PSP™ system will enter sleep mode approximately 10 seconds after this method is 
called. 

You can arbitrarily control the time when sleep mode occurs by calling this method from 
the processing that is invoked by the JavaScript setTimeout. 


This method can be used with system software version 3.98 or later. 


Example 
psp.sysRadioSleep 0: 


This statement causes the PSPT" system to enter sleep mode after approximately 10 


seconds. 


Sample 


<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
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<title>sysRadioSleep</title> 
</head> 
<body> 
<h1>sysRadioSleep</h1> 
<script language="JavaScript"> 
<!-- 
var state = false; 
function test () { 
psp.sysRadioSleep (); 
} 
jt ==> 
</SCript> 
<button onélick="test(): '>TEST</button> 
<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


See Also 


sysRadioCapability Check 
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sysRadioGetSystemStatus 


Inquire about internal status of PSP™ system 


syntax 


psp. sysRadioGetSystemStatus ( id ) 


Arguments 


id Inquiry item ID 


Return Value 


14 Return Value 


>= 1 





Or o o 


Description 


Currently, the only inquiry this method can make is "whether or not sleep mode was 
canceled." 

If 0 is specified for the argument, 1 is returned the first time this inquiry is made, or if 
sleep mode was canceled again since the previous inquiry. At all other times, O 1s returned. 
The PSP™ internal status variable indicating that sleep mode was canceled is reset by 
calling this method. 


This method can be used with system software version 5.00 or later. 


id Inquiry Contents 


0 | Was sleep mode canceled after sleep mode was entered? 


Example 
var result = psp.sysRadioGetSystemStatus (0); 
This statement queries whether or not sleep mode was canceled. 
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<html><head> 


<meta http-equiv="content-type" content="text/html; charset=utf-8"> 


<title>sysRadioSleep</title> 
</head> 
<body> 
<h1>sysRadioGetSystemStatus</h1> 
<script language="JavaScript"> 
= 
function test () { 
result = psp.sysRadioGetSystemStatus (0); 
alert (“result = “ + result); 
} 
mr 
</script> 


«button onclick='test(); '>TEST</button> 


<object name="psp" type="application/x-psp-extplugin"></object> 


</body></html> 


sysRadioCapabilityCheck 
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Sample 


See Also 


©SCEI 


4 Procedure for Developing an Internet Radio Player 





Overview 


This chapter describes the procedure for developing an Internet radio player of the type that 
receives a broadcast by first accessing a broadcast station database to get information related 
to third-party Internet radio broadcast stations and then connects to a broadcast server using 
information in that database. 

The example shown here is of an Internet radio player that processes information from the 
Icecast Stream Directory Web page, which 1s administered by 1cecast.org, to get broadcast 
station information. This 1s the same processing used by the "Internet Radio Player II" 


provided by SCE. 
The workflow to create the Internet radio player 1s as follows. 


Create an 1mage of the completed form of the Internet radio player. 
Create graphic elements based on the 1mage of the completed form. 
Roughly sketch out the html, css, and JavaScript that will make up the components of 
the Internet radio player. 

€ Copy the image files, html files, css files, and JavaScript files to a Memory Stick Duo™ 
and use a test Internet radio player icon to perform a rough display test on the PSP™ 
system. 


€ Create the JavaScript code. 


The workflow described above is the rough procedure for developing the Internet radio player. 


Afterwards, the following tasks must be performed to complete the development process: 


€ ‘Transfer all completed files to the Web server where the Internet radio player will be 
located. 
Create the Internet radio player icon. 


Make the Internet radio player and radio player icon files publicly available on a Web 


page. 
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Use the files included in the SDK (PSP™ Internet radio player software development kit) to 


follow the procedure for developing Internet radio player software up to the step of "creating 


the JavaScript code." 


HINT 

Although the Internet radio player will ultimately be placed on a Web server, placing it 

ona Memory Stick Duo™ during an intermediate stage of the development process may 
increase work efficiency since it will not be necessary to perform FTP transfers. 

This chapter describes how to use the Internet radio player from a Memory Stick Duo™. 
Note that since an Internet radio player that is placed on a Memory Stick Duo™ cannot 


use cookies, an actual Web server must be used to check proper operation of cookies. 


Also, when an actual Web server is used, we recommend that you configure the HTML 
or the Web server so that the browser cache 1s disabled to ensure that the page 1s 


reliably reloaded by a "page reload" operation of the PSP™ Internet browser. 


Example showing how to disable the browser cache in the Web server (for Apache) 


.htaccess 
<Files ~ "\. (html|htm|css|js|jpg|jpeg|png|gif)$"> 





Header add Pragma "no-cache" 
Header set Cache-Control no-cache 
</Files> 
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OSCEI 


1. Create an image of the completed form 


Determine the overall design including the complete image, areas for user interaction, text 


display, etc. 


As an example, suppose we create a radio for choosing between two genres as shown in the 
following figure. 

This Internet radio player has a selector and operation guides indicating the meaning of the 
selector position. 

The selector, which takes two states, has the explanatory text "JAZZ" and "OR NOT" as 
operation guides to match the two state values. 

These two text strings can be drawn in advance on the background image since the Internet 


radio player does not dynamically change the display. 


Note that this Internet radio player does not have a function for displaying music information 


or broadcast station information for the music that 1s playing. 


/ : A Operation guide Operation guide 


e Selector 
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2. Create graphic elements 


Prepare the graphic elements that will make up the player. 
In this player, one background image and two selector images (one for the ON state and one 


for the OFF state) for a total of three images are prepared in advance. 


Background image 


Filename: "bg.gif" 


Selector image (ON 
state) 


Filename: "on.gif" 


Selector image 


(OFF state) 


Filename: "off.gif" 
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Note) These three image files are recorded in the directory 


"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER/PLAYER SAMPLE/JAZZ/1st step/images/"in the 


SDK. 
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3. Create directories on the Memory Stick Duo™ and copy image files 


« Connect the PSP™ system to a PC with a USB cable. 
Select "Settings" > "USB Connection" to switch the PSP™ system to USB mode. 
Verify that the PSP™ system is mounted as mass storage on the PC. 


Create directories on the Memory Stick Duo™. 


To use the PSP™ as a sample player, use the procedure described above to connect the PSP™ 


system to a PC and create the directory "radio tmp" and the subdirectories "css," "images," 


and "js" under it. 







Memory Stick Duo™ radio tmp 


images 


js 
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" 


Copy the three image files that were created in "2. Create graphic elements " to the "images 


directory. 


Memory Stick Duo" radio tmp 


images 


js 


Oo 
Q 
a) 
==, 
Va / 


o 

D 
e 

— 


oO 

3 
Q 

— 





HINT 
There is no problem if the directories are created and the files are copied to the 
Memory Stick Duo™ from the PC in some other way besides the PSP™ system's USB 


mode. 
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4. Create html, css, and JavaScript files and copy them to the 
Memory Stick Duo™ 


"o "on 


Use a text editor to create "index.html," "basic.css," "switch.css," "properties.js," and 


"radiocore.js" as UTF-8 encoded files and copy each of these files to the prescribed directory. 


At this point, the Internet radio player will not be fully functional and only the graphics will 
be displayed. 


radio tmp/index.html 

<html> 
<head> 
<link href="css/basic.css" rel="stylesheet" type="text/css" /> 
<link href="css/switch.css" rel="stylesheet" type="text/css" /> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>&#32;</title> 
</head> 
<script language="JavaScript" src="./js/properties.js"></script> 
<script language="JavaScript" src="./js/radiocore.js"></script> 
<img id="face" src="images/bg.gif" width="480" height="272" border="0"> 
<a href="JavaScript:"> 
<img id="toggleSwitch" name="toggleSwitch" 

onMouseOver='sw(0);' 

onMouseOut='sw(1);' 

onMouseDown='sw(2);' 

onMouseUp='sw(3);' 

src="images/off.gif" width="209" height="204" /> 
</a> 
</body> 
</html> 


radio_tmp/css/basic.css 
body + 
margin: 0; 
background-repeat: no-repeat; 


) 
#face { position: absolute; left: Opx; top: 


radio_tmp/css/switch.css 
#toggleSwitch { position: absolute; left: Opx; top: 67px; 


radio_tmp/js/properties.js 
var title = "Jazz, Or Not, That Is The Question"; 
onKeywords = new Array ( "Jazz" ); 
offKeywords = new Array 
(. "Classical", "International", "Turkish", "Folk" ); 
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radio tmp/js/radiocore.js 
if ( navigator.mimeTypes 
&& navigator.mimeTypes ["application/x-psp-extplugin"] ) (I 
var plugin 
- navigator.mimeTypes ["application/x-psp-extplugin"].enabledPlugin; 
if ( plugin ) { 
document.write 
("<object name=psp type=\"application/x-psp-extplugin\" >" 
+"</object>\n"); 
} 
} 
else psp = null; 
function onLoadProc () ( 
document.title = title; 
) 
function onUnLoadProc () {} 
var switchState - false; 
function sw ( mode ) ( 
switch ( mode ) ( 
case 2: 
if ( psp ) psp.sysRadioPlayEffectSound (); 
switchState = !switchState; 
if ( switchState ) document.toggleSwitch.src - "images/on.gif"; 
else document.toggleSwitch.src - "images/off.gif"; 
break; 
default: 
break; 


) 





Note) The "radiocore.js" code shown above performs a simple display test. Code to support 


Internet radio player functionality will be added later. 

Note) The parts highlighted in red specify css files, JavaScript files, and image files. To use 
different directories or files (different directory names or filenames), change these 
appropriately. 


Note) The part highlighted in orange indicates a location where an extended method is used. 


Note) You can find these five text files in the directory 


"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER/PLAYER SAMPLE/JAZZ/1st step/"in the SDK. 
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Memory Stick Duo"" radio tmp css basic.css 


IL 


images switch.css 


| 


js properties.js 


NN 
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index.html radiocore.js 


OSCEI PSP™ Internet Radio Player Development Guide 


- 218 - 


5. Copy the test Internet radio player icon file to the Memory Stick Duo™ 


Copy the test Internet radio player icon file 
"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER ICON/PRS/test player.prs," which is included in 


the SDK, to the "/psp/RADIOPLAYER/" directory of the Memory Stick Duo™. 


Memory Stick Duo™ PSP RADIOPLAYER ' test player.prs 


This Internet radio player icon file will cause an icon to be displayed on the XMB™ at the 
"Internet radio" level of the "Network" column. By selecting and activating this icon, 
"/radio tmp/index.html" on the Memory Stick Duo™ will be started up as an Internet radio 


player. 


6. Unmount the PSP™ system from the PC and then cancel the PSP™ 
system’s USB mode 


Cancel the connection of the USB mode PSP™ system, which is being recognized (mounted) as 


mass storage, from the PC and then cancel the USB mode of the PSP™ system. 
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7. Try starting up the Internet radio player from the test Internet player icon 


Select "TEST PLAYER," which is displayed on the "Internet radio" layer in the "Network" 
column of the XMB™ which will start up the Internet radio player. 


12/13 14:29 fj] 


TEST PLAYER 





The Internet radio player is started up from "/radio tmp/index.html" on the 


Memory Stick Duo™. This can be verified from "Information" on the options menu. 


13/12 14:33 du) 


Internet Radio TEST PLAYER 
Player 


Address file:/radio tmp/index.htmi 


Comment s 


Website 
—- 1 p 
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After start up, the Internet player screen is displayed as shown below. 


UK NU | 





At this point, only simple JavaScript code has been defined, so the player is not fully 
functional and can only display an image on the screen. It still cannot connect to an Internet 


radio broadcast station or play any audio. 
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8. Create JavaScript code 


Implement JavaScript code so that the software functions as an Internet radio player. 

Most of the JavaScript code is used for accessing the Stream Directory page of icecast.org 
(http://dir.xiph.org/index.php), getting page information, parsing strings, and extracting 
broadcast station information. Since a detailed explanation of the Stream Directory's Web 
APIs 1s beyond the scope of this document, it has been omitted here. Comments explaining this 


processing are included in the code below for your reference. 


radio tmp/js/radiocore.js 


Sample program ("XXX or Not" type Internet radio player series only) for 
getting broadcast station information from icecast.org's Stream 
Directory and connecting to the broadcast station 


Note: There is no guarantee that this program code always runs properly. 


Supplement: Orange parts are PSP™ Internet radio extended JavaScript methods. 
Red parts specify image file names. 
Green parts are string constants. 
Blue parts are comments. 


( navigator.mimeTypes 

&& navigator.mimeTypes ["application/x-psp-extplugin"] ) { 

var plugin 

= navigator.mimeTypes ["application/x-psp-extplugin"] .enabledPlugin; 

(plugin 7 À 

document.write 
("<object name=psp type=\"application/x-psp-extplugin\" >" 
+"</object>\n") ; 


if 


) 
) 
else psp = null; 
var isPSPRadio - false; 
window.onload = onLoadProc; 
window.onunload = onUnLoadProc; 


// Processing performed when the page is loaded 
// 
function onLoadProc () ( 

document.title = title; // Sets the title. 


Since the time when a psp object is created by document.write 
(in other words, the time when the psp object can be referenced) 
and the time when onLoadProc is called are not synchronous, 
perform processing with a slight time difference by intentionally 
delaying initialization processing, which requires processing for 
referencing the psp object. 
Set a timer for this. 

timerID for initProc = setTimeout (initProc, 1500); 


// Processing performed when page is unloaded 

// 

function onUnLoadProc () /* This player does not perform any processing. 
When some page had been opened in a separate tab, 
processing for closing the page can be performed by 
describing the page closing processing in this function. */ 


// Timer ID variables 

var timerID for initProc = 0; // Timer for slightly delaying initialization processing 

var timerID for httpGetProc = 0; // http get processing timer 

var timerID for streamStatusCheckProc = 0; // Timer for checking audio stream reception 
// status 
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// web APIs for accessing icecast.org's Stream Directory 
var icecastStreamDirectoryUrl 

= "http://dir.xiph.org/search?start=0&num=50&search=":; 
var icecastM3uUrl = "http://dir.xiph.org";* 


var bAacpSupport = false; // Whether or not an AAC+ stream can be played 

var bNowHttpGetIsBusy = false; // True when http get processing is being performed 

var bInAnalizingStationListString = false; // True when string parsing is being performed 
var bForcedExitFlag = false; // Flag for interrupted string parsing 


var streamStatusCheckProcWorkState = 0; // State value for producing tuning sound 
var maxNumStation = 40; // Maximum length of broadcast station list 


var numStationList 0; // Length of broadcast station list 
var currentStation = 0; // Broadcast station being received 


// User agent name (for stream reception, for http get, for M3U acquisition) 
var userAgentForPlayStream = "PSP-InternetRadioPlayer-Sample/1.00"; 

var userAgentForHttpGet = userAgentForPlayStream; 

var userAgentForGetM3u = userAgentForPlayStream; 


var stationArray = new Array (0); // Initial value of broadcast station list (empty array) 


PT esse ennemis 
// Initialization function 
ff Soon ma maa ea ae n hh m m m t m hm tnn em 
function initProc () (I 
// Release timer ID resources 
ClearTimeout (timerID for initProc); timerID for initProc = 0; 
// Set timer for monitoring audio stream reception status. 
timerID for streamStatusCheckProc 
= setTimeout ('streamStatusCheckProc ()', 1500); 
if (psp ) ( 
psp.sysRadioBackLightAlwaysOn (1); // Set LCD backlight always on. 
isPSPRadio = true; /* Because of the processing up to here, this code 
is recognized to be running on an Internet browser that 
was started as an Internet radio player. */ 
psp.sysRadioSetDebugMode (0); // Turn debug mode off 
psp.sysRadioSetSubVolume (0); // Set sub volume to minimum in advance. 
psp.sysRadioSetMasterVolume (255); // Set main volume to maximum in advance. 
// Check whether AAC+ stream can be played (false on PSP-1000; true on PSP-2000) 
bAacpSupport = psp.sysRadioCapabilityCheck (0) ? true : false; 
// The genre name (search string) of the broadcast produced first is determined by 
// a random number of the OFF-side array. 
var n - offKeywords.length; 
var m - Math.floor (Math.random () * (n + 1((; 
17 ( n «e 1i) ii -m- 7 
// Prepare for getting broadcast station list. 
prepareForGetStationList (offKeywords [m]); 
) 
) 
[i Br a Eee תרכה ההכה הטש הרהה כ לש כ דא כ ל ה ההכ ד‎ = SS aa 


// Function called when the switch is operated. 
// Note) the caller is defined in index.html. 


Ja ccc mm 
var switchState - false; // Variable for saving ON/OFF status of switching knob 
function sw ( mode ( + 
switch ( mode ) ( 
case 2: // onMouseDown 
if ( bNowHttpGetIsBusy ) return; // Disabled during http get processing 
// If string parsing is being performed, that processing is interrupted. 
if ( bInAnalizingStationbistString ) bForcedExitFlag = true; 
if ( isPSPRadio ) 
psp.sysRadioPlayEffectSound (); // Click sound is emitted for sound production. 
switchState - !switchState; // Reverse selector state. 
if ( switchState ) ( // When it is ON 
document.toggleSwitch.src - "images/on.gif"; // Switch picture 
// Choose one keyword from "ON" array. 
// Note) Since the "ON" array described in properties.js has one element, 
// the same one is always selected. However, to support the case of two or 
// more elements, equivalent processing is performed as for "OFF." 
var n = onKeywords.length; 
var m = Math.floor (Math.random () * (n + 1)); 
if (n<=m)m=n - 1; 
// Prepare for getting broadcast station list. 
prepareForGetStationList (onKeywords [m]); 
else ( // When it is OFF 
document.toggleSwitch.src - "images/off.gif"; // Switches picture 
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var n = offKeywords.length; 
// Choose one keyword from "OFF" array. 
var m = Math.floor (Math.random () * (n + 1)); 
LÉ À nn <= mm ) m = n — 1; 
// Prepare for getting broadcast station list. 
prepareForGetStationList (offKeywords [m]); 
) 
streamStatusCheckProcWorkState - 0; // Reset state 
// Produce sound for representing "state when tuning is being performed" 


if ( Math.random () « 0.5 ) psp.sysRadioSetAudioShiftWidth (-25); 
else psp.sysRadioSetAudioShiftWidth (15); 
break; 
default: 
break; 
} 
} 
ff SSS SSS EE EE ee aMMa MM 
// Function for preparing to get broadcast station list from icecast.org's Stream Directory 
pg eee eee Eu Eu simis 
function prepareForGetStationList ( keyword ) + 
if ( ! isPSPRadio ) return; 
psp.sysRadioBusyIndicator (1); // Turn busy indicator display on. 
// Assemble icecast.org's Stream Directory keyword search Web API. 
var url = icecastStreamDirectoryUrl + escape (keyword); 
var size = 49152; // Set size of acquisition data (this value is maximum value) 
// Prepare for http get and starts processing in background. 
psp.sysRadioPrepareForHttpGet (url, userAgentForHttpGet, size, 0); 
bNowHttpGetIsBusy = true; // Set processing-in-progress flag to true. 
httpGetProc (); /* httpGetProc is a function that is polled by using a timer 
It is called from here only the first time. 
Later, it continues to set a timer and call itself until http get 
processing is completed. */ 
) 
na SS SS SS SS SSS SS SS SSS SS SSS SSS SS SS SS SS SS SS SS SS SS SSS SS SSS 
// Function for monitoring http get processing status 
ME Lm 
function httpGetProc () + 


// Temporarily clear timer resource. 

if (0 « timerID for httpGetProc ) + 
clearTimeout (timerID for httpGetProc); 
timerID for httpGetProc = 0; 

) 


// Return when http get processing is completed. 


if ( ! bNowHttpGetIsBusy ) return; 
if ( ! isPSPRadio ) return; 
result - psp.sysRadioGetHttpGetStatus (); // Get http get processing status 
if ( result == 1) { // When processing is in progress 
// Set timer for calling itself and returns. 
timerID for httpGetProc = setTimeout ('httpGetProc ()', 500); 
return; 
) 
else if ( result == -1 ) { // When an error occurs 


bNowHttpGetIsBusy = false; // Reset flag that indicates http get processing is in 
//progress. 
return; // Return when an error occurs. 
} 
// Get result of http get processing. 
var stationListStr = psp.sysRadioGetHttpGetResult (); 
// Since http get processing is finished, calls method for releasing internal resources. 
psp.sysRadioHttpGetTerminate (); 
bNowHttpGetIsBusy = false; // Reset flag that indicates http get processing is in 
//progress. 
delete stationArray; // Temporarily release broadcast station list array. 
// Parse string obtained from http get to create array (broadcast station list). 
stationArray = makeStationList (stationListStr); 
// Perform processing for clipping upper limit of number of broadcast station list 
// entries (substantially meaningless). 
var n = stationArray.length; 
if ( maxNumStation « n ) (I 
n - maxNumStation; 
stationArray - stationArray.slice (0, maxNumStation); 
) 
numStationList - n; // Number of broadcast station list entries 
if ( numStationList == 0 ) { // When acquisition fails 
if ( bForcedExitFlag == false ) { // And when not forcibly interrupted 
// This state means that no station corresponding to the selected genre exists. 
// Pseudo white noise is generated as sound production. 
psp.sysRadioSetWhiteNoiseOscillatorVolume (80); 
// Set sub volume to minimum value. 
psp.sysRadioSetSubVolume (0); 
// Consider cross feed condition and stop playback. 
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psp.sysRadioStop (); 
// Turn busy indicator display off. 
psp.sysRadioBusyIndicator (0); 


currentStation = 0; // Reset variable 
return: 


} 


// When broadcast station list is successfully generated. 
bForcedExitFlag = false; // Resets flag 
// Randomly select on station from list of stations that was obtained. 
currentStation = Math.floor (Math.random () * (numStationList + 1)); 
if ( numStationList <= currentStation ) 

currentStation = numStationList - 1; 
// Connect to selected broadcast station and begin reception. 
tune (currentStation) ; 
// Turn busy indicator display off. 
psp.sysRadioBusyIndicator (0); 


} 


JI emmmer EE EE EE E EE EE E E E E e el 
// Function for starting reception 
// Note) Connect to station specified by stationNumber in broadcast station 


// list and begin reception. 


Jf EE 
function tune ( stationNumber ) ( 
if ( numStationList -- 0 ) return; // Return when broadcast station list is empty. 
if ( numStationList «- stationNumber ) return; // Also returns when out of range. 
psp.sysRadioBusyIndicator (1); // Turn busy indicator display on. 
// Assemble URL for accessing M3U data. 
var m3uURL = icecastM3uUrl + stationArray [stationNumber].m3u; 
// Specify URL of M3U data to start receiving broadcast. 
psp.sysRadioPlayM3u 
(m3uURL, userAgentForGetM3u, userAgentForPlayStream); 
) 
a ccc LE 


// Function for monitoring audio stream reception status 
// Note) Processing is performed at fixed intervals according to a timer. 


[| —————————————————Ó———————————————————————————————————————————- 
function streamStatusCheckProc () + 
// Temporarily release timer resource. 
if (00 « timerID for streamStatusCheckProc ) ( 
ClearTimeout (timerID for streamStatusCheckProc); 
timerID for streamStatusCheckProc = 0; 
1 
/* When not operating as a PSP™ Internet radio player, reset timer and return. 
Note) Except when verifying (debugging) rough JavaScript operation using an ordinary 
browser, this case need not be considered. */ 
if ( ! isPSPRadio ) ( 
timerID for streamStatusCheckProc 
= setTimeout ('streamStatusCheckProc ()', 1500); 
return; 
} 
// When broadcast station list is empty,set timer to a long interval and returns. 
if ( numStationlist == 0..) 4 
timerID for streamStatusCheckProc 
= getTimeout ('streamStatusCheckProc ()', 4000); 
return; 
) 
switch ( streamStatusCheckProcWorkState ) ( 
case 0: // First state. This is for gaining time for sound production. 
( 
// Get player system core's playback status (internal status) value. 
var result = psp.sysRadioGetPlayerStatus (); 
switch ( result ) { 
case -1: // Error 
case 1: // Playing 
case 4: // Connecting to broadcast server 
case 0: // No processing is being performed 
streamStatusCheckProcWorkState - 1; // Transition to next state 
break; 
case 2: // Getting M3U data 
case 3: // Parsing M3U data 
default: 
break; 
} 
} 
break; 
case 1: 
/* When http get is not being processing in the background and 
string parsing is not being performed . . . */ 
if ( ! bNowHttpGetIsBusy && ! bInAnalizingStationListString ) { 
// Transition to next state (state provided for sufficiently creating sound 
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// production interval). 
streamStatusCheckProcWorkState = 2; 
) 


break; 
case 2: // Finally, continue monitoring playback status in this state. 
default: 
psp.sysRadioSetAudioShiftWidth (0); // Finish sound production. 
psp.sysRadioSetSubVolume (255); // Set sub volume to maximum value. 


{ 
// Get player system core's playback status (internal status) value. 
var result = psp.sysRadioGetPlayerStatus (); 


switch ( result ) { 
case 0: // No processing is being performed 
break; 


case -1: // Error 
// Switch to next station in broadcast station list. 
if ( numStationList ) 
currentStation - (currentStation + 1) $ numStationList: 
// Connect to broadcast station to begin reception. 
tune (currentStation); 
break; 
case 1: // Playing 
default: 
// Forcibly stop stream on opposite side of cross fade. 
psp.sysRadioStop (1); 
// Turn busy indicator display off. 
psp.sysRadioBusyIndicator (0); 
// Stop pseudo white noise. 
psp.sysRadioSetWhiteNoiseOscillatorVolume (0); 
break; 
) 
) 
break; 
) 
// Set timer for calling itself and returns. 
timerID for streamStatusCheckProc 
= setTimeout ('streamStatusCheckProc ()', 1500); 


// 


// Parse icecast.org's Stream Directory Web page's html as a string to 
// create a broadcast station array (list). 


PT == םש שש‎ ss 
// Group of search keywords for parsing the string 
var keyword_begin = "<table class=\"servers-list\">"; 
var keyword_beginStationRec = "<p class=\"stream-name\">"; 
var keyword_preRefPage = "<span class=\"name\"><a href=\""; 
var keyword_preRefPageB = "<span class=\"name\""; 
var keyword_postRefPage = "\""; 
var keyword_preStationName = ">"; 
var keyword_postStationName = "</a></span>"; 
var keyword_postStationNameB = "</span>"; 
var keyword_preListeners = "<span class=\"listeners\">["; 
var keyword postListeners = "&nbsp;listener"; 
var keyword preComment = "<p class=\"stream-description\">"; 
var keyword postComment = "</p>"; 
var keyword preM3uUrl = "<p>[ «a href=\""; 
var keyword postM3uUrl = "NV" title=V""; 
var keyword preBitrate - "«p class=\"format\""; 
var keyword postBitrateA - "»"; 
var keyword postBitrateB = " title=V""; 
var keyword postBitrateB2 = "V">"; 
var keyword protocol MP3 = "Mp3"; 
var keyword protocol AACP = "AAC+"; 
var keyword endStationRec = "«/tr»"; 
function makeStationList ( stationListString ) ( 
stationRec = new Object ();// Working object 
var currentPos = 0; // String processing position pointer 
var startPos = 0; // Working character position pointer 
var endPos = 0; // Working character position pointer 
var stationRecEnd = 0; 
var prevCurrentPos = -1; // Working character position pointer 
var state = 0; // State variable for distinguishing parsing keyword 
var count = 0; // List size (number of entries) counter 
psp.sysRadioPrepareForStrOperation (stationListString); // Prepare for string 
// processing 
var length - psp.sysRadioStrLength (); // String length 
var bExit - false; 
var bNoRefPage - false; 
var stationList - new Array (0); // Initialize array returned as return value 


bInAnalizingStationListString = true; // Set string-parsing-in-progress to true 
// Repeat until end of string is reached or processing is forcibly interrupted 
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while ( bExit == false && bForcedExitFlag == false ) ( 


switch ( state ) ( 
case 0: // Skip beginning part (this processing is performed only once when parsing 
// starts) 
currentPos = psp.sysRadioStrindexOf (keyword begin, currentPos); 
state = 2 
break; 


case 1: // URL of related page 
// Initialize variable for temporarily storing broadcast station information 
// here. 
bNoRefPage = false; 
stationRec.rp - stationRec.name - stationRec.lc - stationRec.comment 
= stationRec.m3u = stationRec.br s m". 
stationRec.protocol = "M"; 
startPos 
- stationListString.indexOf (keyword beginStationRec, currentPos); 
15 ( startPos « 0 ) { bExit = true; break; [ 


stationRecEnd 

= psp.sysRadioStrIndexOf (keyword endStationRec, currentPos); 
startPos 

- psp.sysRadioStrIndexOf (keyword preRefPage, currentPos); 
if ( startPos < stationRecEnd ) ( 


startPos += keyword preRefPage.length; 
endPos = psp.sysRadioStrIndexOf (keyword postRefPage, startPos); 
stationRec.rp - psp.sysRadioStrSlice (startPos, endPos); 
currentPos = endPos + keyword postRefPage.length; 
) 
else { 
startPos 
- psp.sysRadioStrIndexOf (keyword preRefPageB, currentPos); 
if ) 0 >= startPos ) currentPos - startPos + keyword preRefPageB.length; 
bNoRefPage = true; 
) 
++state; 
break; 
case 2: // Broadcast station name 
startPos 
- psp.sysRadioStrIndexOf 
(keyword preStationName, currentPos); 
if ) startPos > 0 ( (I 
bExit = true; 
break; 
} 
startPos += keyword preStationName.length; 
if ( bNoRefPage ) ( 
endPos 
- psp.sysRadioStrIndexOf 
(keyword postStationNameB, startPos); 


stationRec.name - psp.sysRadioStrSlice (startPos, endPos); 
currentPos = endPos + keyword postStationNameB.length; 

) 

else ( 
endPos 


- psp.sysRadioStrIndexOf 
(keyword postStationName, startPos); 


stationRec.name - psp.sysRadioStrSlice (startPos, endPos); 
currentPos = endPos + keyword postStationName.length; 
) 
++state; 
break; 
case 3:Listener Count 
startPos 


- psp.sysRadioStrIndexOf 
(keyword preListeners, currentPos); 


if ( startPos « 0 || currentPos == startPos ) ( 
bExit = true; 
break; 


} 
startPos += keyword preListeners.length; 
endPos 
- psp.sysRadioStrIndexOf 
(keyword postListeners, startPos); 
stationRec.lc - psp.sysRadioStrSlice (startPos, endPos); 


currentPos = endPos + keyword postListeners.length; 
++state; 
break; 
case 4: // Comment 
startPos 


- psp.sysRadioStrIndexof 
(keyword preComment, currentPos); 


if ( startPos > 0 || currentPos == startPos ) ( 
bExit = true; 
break; 
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) 
startPos += keyword preComment.length; 
endPos 

= psp.sysRadioStrIndexof 

(keyword postComment, startPos); 


stationRec.comment - stationListString.slice (startPos, endPos); 
currentPos = endPos + keyword postComment.length; 
++state; 
break; 
case 5: // M3U URL 
startPos 


- psp.sysRadioStrIndexOf 
(keyword preM3uUrl, currentPos); 


if ( startPos « 0 || currentPos -- startPos ) ( 
bExit - true; 
break; 


) 
startPos += keyword preM3uUrl.length; 
endPos 
- psp.sysRadioStrIndexOf 
(keyword postM3uUrl, startPos); 
stationRec.m3u = psp.sysRadioStrSlice (startPos, endPos); 
currentPos - endPos + keyword postM3uUrl.length; 
++state; 
break; 
case 6: // Bit rate 
startPos 
- psp.sysRadioStrIndexOf 
(keyword preBitrate, currentPos); 


if ( startPos « 0 || currentPos == startPos ) { 
bExit = true; 
break; 


} 
startPos += keyword preBitrate.length; 
var endPosA 
- psp.sysRadioStrIndexOf 
(keyword postBitrateA, startPos); 
var endPosB 
- psp.sysRadioStrIndexOf 
(keyword postBitrateB, startPos); 
if ( endPosA « endPosB ) 
currentPos - endPosA -« keyword postBitrateA.length; 
else { 
startPos += keyword_postBitrateB.length; 
endPos 
- psp.sysRadioStrIndexOf 
(keyword postBitrateB2, startPos); 
stationRec.br = psp.sysRadioStrSlice (startPos, endPos); 
currentPos = endPos + keyword_postBitrateB2.length; 
} 
++state; 
break; 
case 7: // Protocol 
var protocol MP3 
- psp.sysRadioStrIndexOf 
(keyword protocol MP3, currentPos); 
var protocol AACP 
- psp.sysRadioStrIndexOf 
(keyword protocol AACP, currentPos); 
if ( 0 <= protocol MP3 && protocol MP3 < stationRecEnd ) 


stationRec. protocol = "M": 
else if ( 0 <= protocol AACP && protocol AACP « stationRecEnd ) 
stationRec.protocol = "A": 
else stationRec.protocol = "O"; 
currentPos = stationRecEnd + keyword endStationRec.length; 
if ) ) currentPos < prevCurrentPos ( 
| ( prevCurrentPos == currentPos ) 
( length - 1 <= currentPos ) ) { 
bExit = true; 
} 
else { 
15 ) ( bAacpSupport && stationRec.protocol == "A" ) 
|| stationRec.protocol == "א"‎ ( ) 
// Add extracted information for one broadcast station to array 
/* Note) Even information not used by this radio player 
is collected in this array. */ 
stationList.push 
((stationName: stationRec.name, 
comment: stationRec.comment, 
br: stationRec.br, 
m3u: stationRec.m3u, 
agcp: (stationRec.protocol == "A" 
? true : false, 
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refPage: stationRec.rp, 
streamUrl: "" 
ו‎ 
++count; // Increment counter 
if ( maxNumStation «- count ) bExit = true; // Check upper limit 
) 
) 


prevCurrentPos = currentPos; 
state = 1; // Prepare for extracting information for next broadcast station. 


// Repeat processing from state 1. 
break; 
) 
) 


psp.sysRadioStrOperationTerminate ();// Terminate string processing. 
// When forcibly interrupted, created array is discarded, empty array is set, and 
// processing returns. 
if ( bForcedExitFlag ) ( 
delete stationList; 
stationList - new Array (0); 


) 
bInAnalizingStationListString = false; // Set string-parsing-in-progress to false. 


delete stationRec; // Release working object. 
return ( stationList ); 





Note) The "radiocore.js" text file is included in the directory 


"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER/PLAYER SAMPLE/JAZZ/2nd step/js/"in the SDK. 






Memory Stick Duo"" radio tmp 





images 


js radiocore.js 





Use a procedure similar to the one described above to copy the "radiocore.js" file to the 


Memory Stick Duo!M, 
Now, when the test Internet radio player icon "TEST PLAYER" (test player.prs) is started up, 


broadcast station information will be obtained from icecast.org and a broadcast will begin to be 


received. 
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9. Change css and image files to create another Internet radio player 


Let's try to create another player by remodeling the "Jazz or Not" Internet radio player that 
was created above. 
Create an image of the completed form and create graphic elements as described earlier in 


steps 1 and 2. 


Background image 


Filename: "bg.gif" 


Switch image (ON 
state) 


Filename: "on.gif" 


Switch image (OFF 


state) 


Filename: "off.gif" 





Note) These three image files are included in the directory 


"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER/PLAYER SAMPLE/LATIN/images/"in the SDK. 
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Copy these image files to the prescribed directories as described in step 3 above. 


Memory Stick Duo"" radio tmp CSS 
NE 0 
images bg.gif 
a ה‎ 
js on.gif 


| 


off.gif 





In addition, copy index.html, switch.css, and properties.js to the prescribed directories as 


described in step 4 above. 


radio tmp/index.html 

<html> 
<head> 
<link href="css/basic.css" rel="stylesheet" type="text/css" /> 
<link href="css/switch.css" rel="stylesheet" type="text/css" /> 
<meta http-equiv="content-type" content="text/html; charset=utf-8"> 
<title>&#32;</title> 
</head> 
<script language="JavaScript" srcs"./j]85/otoperties.]5'»«/scripte 
<script lanquages"JIavaScript" srcos"./js/radiocore.js"»«/script- 
<img id="face" sre="images/bg.gif" width="480" height="272" border="0"> 
<a href="JavaScript:"> 
<img id="toggleSwitch" name="toggleSwitch" 

onMouseOver='sw(0);' 

onMouseOut='sw(1);' 

onMouseDown='sw(2);' 

onMouseUp='sw(3);' 

src="images/off.gif" width="140" height="140" /> 
</a> 
</body> 
</html> 


radio_tmp/css/switch.css 
#toggleSwitch { position: absolute; left: Opx; top: 109px; 


radio tmp/js/properties.js 
var title = "Latin, Or Not, That Is The Question"; 
onKeywords - new Array ( "Latin" ); 
offKeywords - new Array ( "British", "Techno", "HardRock", "Metal" ); 
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Note) These text files can be found in 
"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER/PLAYER SAMPLE/LATIN/index.ht1" and in the 
"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER/PLAYER SAMPLE/LATIN/css/" and 


"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER/PLAYER SAMPLE/LATIN/js/" directories in the SDK. 


Memory Stick Duo"" radio tmp css basic.css 


JE ` 





images switch.css 
9 ה‎ 
js properties.js 
0 | 
index.html radiocore.js 


This completes the "Latin or Not" Internet radio player, which was created by remodeling the 
"Jazz or Not" Internet radio player. 
If it is started up from the "TEST PLAYER" Internet radio icon, a LATIN-specific player will 


be launched as shown below. 
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10. Create an Internet radio player with completely different functions and 
design 


The previous section briefly described how you can implement an Internet radio player that 
has practically the same functions and slightly different design by replacing the css and image 
files. This 1s a so-called "skin replacement" technique. 

However, an implementation of an Internet radio player with completely different functions, a 
completely different method of operation, or a completely different design cannot implement 
those differences by just replacing css or image files. A lot of JavaScript code must be 


rewritten or newly written. 


The files for the "Internet Radio Player II" provided by SCE are included in the SDK. 

Since they were not implemented under the assumption that they would be used as 
explanatory materials, there are few comments and the code is not easy to read. However, you 
should refer to the code when developing software for a new Internet radio player. 

The directory in which the "Internet Radio Player II" source code can be found in the following 


directory: "PSP INTERNET RADIO PLAYER SDK/SAMPLE/INTERNET RADIO PLAYER II/". 


11. Supplement 


The Internet radio players provided by SCE and the Internet radio players introduced in this 
document are able to access a broadcast station database and parse that information entirely 
on the client (via JavaScript running on the PSP™). This is done to lighten the load on the 
Web server where the Internet radio player is located. It is also done to provide portability and 


to narrow the scope of the explanations in this document. 


Since it is not absolutely necessary to perform this processing solely on the client, a server-side 


implementation (using cgi or cron) is also possible. 
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5 Creating the Internet Radio Player Icon 





In the previous chapters, we placed the Internet Radio Player on the Memory Stick Duo™ and 
launched it from the Internet radio player icon "TEST PLAYER," which is recorded in the SDK, 
and then tested the radio player's operation. 

However, to actually make an Internet radio player publicly available, the Internet radio 
player must finally be placed on a WWW server, and an Internet radio player icon specific to 
that Internet radio player is required to access that WWW server. 


This chapter describes how to create this Internet radio player icon. 


What is an Internet Radio Player Icon? 


An Internet radio player 1con 1s displayed at the "Internet radio" level 1n the "Network" 
category of the XMB™. These icons, which have a one-to-one correspondence with Internet 


radio players, exist for starting up the corresponding Internet radio players. 





Internet Radio Player Icon Examples 


This Internet radio player icon includes various types of information such as the "Internet 


"on 


radio player name," "author's name," "Internet radio player URL," "author's web page URL," 
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comment related to the Internet radio player," and "copyright information" and image data for 
collecting this information together and displaying it as an icon. It can also include icon focus 


image data for indicating that this icon has been selected on the XMB™. 
This Internet radio player icon entity (Internet radio player icon file), which is a file having 


the extension "prs," is stored in the directory shown in the following figure on the 


Memory Stick Duo™ media. 


Memory Stick Duo™ PSP RADIOPLAYER XXXX.prs 





This Internet radio player icon file can be created by using a special-purpose tool to process a 
file described in XML format. 
This XML format file describes the information shown in the following table. Although several 


items are optional, the items shown in red are required. 


Internet radio player name 


1con Icon image filename Optional 


Icon focus image filename Optional 


author Author's name Optional 


radioplayer url Internet radio player URL 


homepage url Author's web page URL Optional 


Comment related to Internet radio player Optional 


copyright Copyright information Optional 





Specifically, this information 1s described as shown in the following example. 


RADIO PLAYER ICON TEMPLATE.xml 
«?xml version="1.0" encoding="UTF-8"?> 
<radioplayer title="YOUR PLAYER NAME" 

icon="" 

focus_icon=""> 
<info 

author="YOUR NAME" 


radioplayer url="http://YOUR RADIOPLAYER URL" 
homepage url="http://YOUR HOMEPAGE URL" 
comment="YOUR COMMENT" 

copyright="YOUR COPYRIGHT" 

/> 
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RADIO PLAYER ICON TEMPLATE.xml 


Note) This XML file is recorded as 





"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER ICON/TEMPLATE/RADIO PLAYER ICON TEMPLATE.xml" In 


the SDK. 


For icon, specify an 80 dot by 80 dot 32-bit PNG format image file, and for focus icon, specify a 
100 dot by 100 dot 32-bit PNG format image file. 

If there is no £ocus. icon specification and there 1s an icon specification, the XMB!M 
automatically (dynamically) generates an icon focus image from the image data specified for 


icon. 


Attribute Maximum Number of Maximum Number of File Format 
Name Horizontal Dots Vertical Dots 


[ion 180 Igo | 32-bit PNG format 
32-bit PNG format 





The image files specified for icon and focus_icon should be represented by using a relative 


directory from the XML file (example: icon="./YOUR ICON IMAGE.png"). 


HINT 
The "Internet Radio Player I" icon and "Internet Radio Player II" icon released from SCE 


do not have focus icon; 


The special-purpose tool that processes this XML file to create the "prs" file 1s called the 


"Internet Radio Player Icon Generation Tool." 


What is the Internet Radio Player Icon Generation Tool? 


The Internet Radio Player Icon Generation Tool is a command line tool for compiling the 1con 
information file (XML file). This tool is described by a Python script. 

This tool supports Macintosh (Mac OS X), Linux, and Windows environments. 

Since Python is not installed as a standard tool in Windows, "prscompiler.exe" is recorded in 


the SDK as a Windows-specific tool that can be started up independently by py2exe. 
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How Do you Start Up the Internet Radio Player Icon Generation Tool? 


For Macintosh and Linux 


Copy the XML file to the directory 
" : : "o; 
PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER ICON/WORK/Macintosh and Linux/"in the SDK and 


then change to that directory and execute the command as shown below. 
For example, if the XML file is in the same level as the directory in which the SDK was 


expanded and the filename is "YOUR RADIO PLAYER ICON.xml", execute the command 


as follows. 


cp YOUR RADIO PLAYER ICON.xml N 


PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER ICON/WORK/Macintosh and Linux/. 


cd PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER ICON/WORK/Macintosh and Linux 


python prscompiler.py YOUR RADIO PLAYER ICON.xml 





Note) The "\" at the end of the line indicates a linefeed for notational convenience in this 


document. This means that the line actually continues on the next line. 


"YOUR RADIO PLAYER ICON. prs" is created as the result of this processing. 


$ ls -al 
drwxr-xr-x someone staff 12 21 1 

someone staff t2 21- 17709 
-rw-r--r-- someone staff 12 21 17:11 YOUR RADIO PLAYER ICON.prs 
-rw-r--r-- someone staff 12 12 20:05 YOUR RADIO PLAYER ICON.xml 
-rw-r--r-- someone staff 10 14 16:53 cxml.py 


-rw-r--r-- someone staff 12 21 17:10 cxml.pyc 


-rw-r--r-- someone staff 12 10 14:23 prscompiller.py 





9 
© 
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Also, by using the "-o" option, you can create the Internet radio player icon file with an 


arbitrary "prs" filename. 


python prscompiler.py -o foo.prs YOUR RADIO PLAYER ICON.xml 
ls sal 
drwxr-xr-x someone staff 272 L2 21 1 
someone staff 3468 12 21 17:09 


someone staff 416 12 21 17:11 foo.prs 


-rw-r--r-- someone staff 416 12 21 17:11 YOUR RADIO PLAYER ICON.prs 


-rw-r--r-- someone staff 342 12 12 20:05 YOUR RADIO PLAYER ICON.xml 
-rw-r--r-- someone staff 22622 10 14 16:53 cxml.py 
-rw-r--r-- someone staff 15602 12 21 17:10 cxml.pyc 


-rw-r--r-- someone staff 3780 12 7 14:23 prscompiler.py 


9 
ke 
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For Windows 


First, open the command prompt (DOS window). 
Copy the XML file to the directory 
"PSP INTERNET RADIO PLAYER SDK/RADIO PLAYER ICON/WORK/Windows/"in the SDK and then change 


to that directory and execute the command as shown below. 
For example, if the XML file is in the same level as the directory in which the SDK was 
expanded and the filename is "YOUR RADIO PLAYER ICON.xml", execute the command 


as follows. 


copy YOUR RADIO PLAYER ICON.xml \ 


PSP INTERNET RADIO PLAYER SDKNRADIO PLAYER ICONNWORKNWindowsN. 


cd PSP INTERNET RADIO PLAYER SDKNRADIO PLAYER ICONNWORK NWindows 


prscompiler.exe YOUR RADIO PLAYER ICON.xml 





Note) The "\" at the end of the line indicates a linefeed for notational convenience in this 


document. This means that the line actually continues on the next line. 


"YOUR RADIO PLAYER ICON. prs" is created as the result of this processing. 


pr dir 
..«omitted».... 
2007/12/21. 17:11 «DIR» 


2007/12721 17:09 «DIR» 


2007712707 16:13 3,552,487 prscompiler.exe 


2007712721 174111 416 YOUR RADIO PLAYER ICON.prs 
2007 712/12. 20205 342 YOUR_RADIO_PLAYER_TCON. xml 


2 % 





You can also drag and drop "YOUR RADIO PLAYER ICON.xml" onto "prscompiler.exe" 
to create "YOUR RADIO PLAYER ICON.prs." 


OSCEI PSP™ Internet Radio Player Development Guide 


- 239 - 


Note) If "prscompiler.exe" or the XML file is placed in 8 directory with a path name that 


contains Japanese or 8 pathname that contains a space, it may not run normally. 


Also, by using the "-o" option, you can create the Internet radio player icon file with an 


arbitrary "prs" filename. 


C:> prscompiler.exe -o foo.prs YOUR RADIO PLAYER ICON.xml 
Qi dir 
..«omitted».... 
2007712721. 17:11 
20077142721 17709 


2007712721 17:11 416 foo.prs 


20077/12707 16:13 3,552,487 prscompiler.exe 


2007712721 + 4 416 YOUR RADIO PLAYER ICON.prs 
20077/12714 20:05 342 YOUR RADIO PLAYER ICON.xml 


..<omitted>.... 
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How Do You Make the Internet Radio Player Icon That You Created Publicly 
Available? 


You can generally make a "prs" file publicly available by creating a link to the Internet radio 


icon file within an ordinary web page. 


«a href="./YOUR RADIO PLAYER ICON.prs”>YOUR PLAYER ICON</a> 





When the PSP™ Internet browser accesses a link to a file with a "prs" extension, it recognizes 
this extension and automatically performs download processing. The directory to which the file 


is downloaded is "/PSP/RADIOPLAYER" on the Memory Stick Duo!" media. 


However, some WWW servers are configured to handle all files with unknown extensions as 
"text." 

At this time, the PSP™ Internet browser handles a file with a "prs" extension according to the 
WWW server instructions. In this case, the Internet radio player icon file cannot be 


downloaded to the prescribed directory. 


To prevent this kind of invalid operation, we recommend that you set the following 
MIME-Type for the WWW server at which you establish the web page for making the Internet 


radio player icon file publicly available. 


MIME-Type Extension 





application/x-psp-radio-skin 
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6 Appendix 


Terms and Phrases That are Often Used 


The following table shows English and Korean translations of Japanese terms and phrases 
that are used relatively often in the Internet radio player. Use them to globalize or localize 
your Internet radio player. 

For French, Spanish, German, Italian, Dutch, Portuguese, Russian, Simplified Chinese, and 
Traditional Chinese translations, which do not appear in this table, see the 


InternetRadioPlayerMultilingualMessageList.xIs file that is included in the SDK. 


Japanese English 


Avv. 
EEA vn ETT 


JH ESN I PI ILD GARA | Searching for stations in the 
ALA, selected genre 


SSES A 


<N> JED MGARTIRHLFL7: | <ND stations were found <N> Ne] H$T70] 
AE. 
sk ohoxmBa Ud A, There are no stations of the 
selected genre. 


AS Nel 905 
AS MA tt 
et Saut 


“START” הדליה‎ START HES Tam 
YES the system's audio will be muted. | G27] 27} Suc} 
"START" ROVERS ES CHE START YEL F 
IK RED ER ANTE FT muting will be cleared. St aldi 


BORER 


it DMERII NY ERET Switches to another station. QE yero g 
AFPA. 


Related Page xe dal? 


MAI BET DNV TANA | A related page will open in a ya oa US Sepa 
3 separate tab. Fu 


BE N—Y/ HUL No Related Pages Ia pelz 9 


fr ET DNV HAVE וו‎ ha || 7+ eh. 
tA 
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Japanese English Korean 
TIFA 3 ane 


₪ 


JAN) BAA T: 


O AT "ה ממא‎ 


KANE HEGE 


₪ ש< ב ]אגא > IV K:‏ 

Sp 

aki EBLERC SUE A.,T-IZUS | We are sorry. The radio player is 
FINITYFILAV—IFF—/N | being overhauled now. 
—MR—ILFER ACF 

21(--2 9 41+ --4:86 םת‎ | To use the sleep timer, a system 
Ik, AHEODVATFLVYIFULY software update for the PSP™ 
NF vIF—HHIDÆTT system is required. 
FYDT—-RDEEIEDLTIÉÆ | For update methods, refer to the 
HD BLIR EBBET, | instructions for the PSP™ 


system. 


2 om 


LS à 
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7 Update History 





Version Chapter Page Update Description 


EO eee 
1.1 3 20 Updated the section related to the number of JavaScript 
extended methods. 


1. 3 22-25 Updated the "Overview" sections of the 
sysRadioGetLeftAudioPeakLevel and 
sysRadioGetRightAudioPeakLevel methods in the "List of 
JavaScript Extended Methods." 

Added the sysRadioGetLeftAudioAverageLevel, 
sysRadioGetRightAudioAverageLevel, 
sysRadioStrCharCodeAt, 
sysRadioCharacterCodeConvert, and 
sysRadioGetSystemStatus methods to the "List of 
Javascript Extended Methods." 

1 


iP 46-49 Updated the Description of 
sysRadioGetLeftAudioPeakLevel. 
Added sysRadioGetLeftAudioAverageLevel and 


sysRadioGetRightAudioAverageLevel to “See Also”. 


50-53 Updated the Description of 
sysRadioGetRightAudioPeakLevel. 
Added sysRadioGetLeftAudioAverageLevel and 


sysRadioGetRightAudioAverageLevel to “See Also”. 


sysRadioGetRightAudioAverageLevel. 
144,147, | Added sysRadioStrCharCodeAt to "See Also." 
151,155, 


161 


156-158 | Added a Description for sysRadioStrCharCodeAt 
165-167 | Added a Description for sysRadioCharacterCodeConvert. 


Updated the Description of 
sysRadioGetPlayerCoreVersionInfo 


1 
3 
3 
54-57 Added a Description for 
sysRadioGetLeftAudioAverageLevel. 
3 SC 
3 


1 
1 


UE | 192-194 | Updated the Description of sysRadioCapabilityCheck. 
LI | Updated the Description of sysRadioSleep. 
207-208 | Added a Description for sysRadioGetSystemStatus. 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
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